simonlclrs/ticket-ease repository overview

⁠TicketEase

Simple and fast tickets management solution without accounts

⁠Features

Meant to be used locally, this app allows you to create tickets without accounts, with different topics.
People can specify the object of their needs, their name and service, and a priority.
You can indicate the person assigned to a ticket and an admin priority and filter the tickets with various parameters.

⁠Usage

To use this container, you just need to use either of these methods :

• In a docker-compose.yml file :

services:
  ticket-ease:
    image: simonlclrs/ticket-ease:latest
    container_name: ticket-ease
    restart: always
    environment:
      JWT_SECRET: "changeme"
      DEFAULT_DB_LANGUAGE: "en"
      # M365 Config
      # FROM_EMAIL: "[email protected]"
      # TO_MAILS: "[email protected],[email protected]"
      # M365_TENANT_ID: ""
      # M365_CLIENT_ID: ""
      # M365_CLIENT_SECRET: ""
      # MAILS_APP_URL: "https://tickets.example.org"
    ports:
      - "6060:6060"

• Single line command :

docker run \
-p 6060:6060 \
-e JWT_SECRET="changeme" \
-e DEFAULT_DB_LANGUAGE="en" \
--name ticket-ease \
--restart always -d \
simonlclrs/ticket-ease:latest

To edit the admin password with the docker version, simply type :

docker exec -it ticket-ease bun password

For the DEFAULT_DB_LANGUAGE variable, you can pass either "en" or "fr"

⁠Microsoft 365 mails integration

You have the possibility to integrate this app with a Microsoft 365 instance, by providing credentials in the .env file :

• FROM_EMAIL is the address from which to send emails,
• TO_MAILS is the receiving addresses, you can provide multiple separated by a comma,
• M365_TENANT_ID is the tenant ID associated with your instance account,
• M365_CLIENT_ID is the API client ID,
• M365_CLIENT_SECRET is the API client secret,
• MAILS_APP_URL is the app's URL to send in the mails content.

Using this, the addresses setup will receive a new mail every time a ticket is posted.
Make sure to enable mails.send in your 365 instance.

⁠Problems & feature requests

If you have any problem or need a certain feature, do so in the GitLab repository : https://gitlab.com/simonlclrs/TicketEase⁠