billetsys: Modern Support Ticket Solution

English

billetsys is a modern support ticket solution that aims to be easy for all roles to navigate and get their work done quicker.

Features

• Support ticket system with 5 roles (User, Superuser, TAM, Support, Admin)
• Branding
• Public and private messages
• Search across ticket numbers and messages
• Ticket cross-references and mentions
• Article cross-references and mentions
• Ticket shortcuts
• Email integration with per-user format preferences
• CSV ticket import
• Markdown editor with rich content support
• Light and dark mode
• Captcha support, including for forgot-password flows
• Session inactivity handling
• Transport Layer Security v1.3 (TLS) support

Documentation

• Developer guide
• Build and run guide
• Frontend guide

See the releases page for downloads and release notes.

Technologies

billetsys is built with

• Quarkus on Java 25 for the backend
• PostgreSQL for storage
• React and TypeScript on the frontend, bundled with Vite
• shadcn/ui components with Tailwind CSS
• Red Hat Text as the default typeface
• Maven and make for builds
• Node.js and npm for frontend dependencies

Getting started

Clone the repository:

git clone https://github.com/mnemosyne-systems/billetsys.git
cd billetsys

Set up PostgreSQL:

createuser -P ticketdb
createdb -E UTF8 -O ticketdb ticketdb

where the password is ticketdb. Enable access in pg_hba.conf and reload.

The configuration is defined in src/backend/main/resources/application.properties.

Copy the example environment file and fill in the secrets:

cp .env.example .env

Start the support services (CAP + Valkey) with compose:

make platform

This detects whether you have Podman Compose or Docker Compose and starts the containers defined in docker-compose.yml. If neither is installed, the command is skipped with a warning.

Start billetsys in development mode:

make

The application is available at http://localhost:8080.

Test accounts

The users defined for testing are

• User: user1 / user1
• User: user2 / user2
• User: userb / userb
• Superuser: superuser1 / superuser1
• Superuser: superuser2 / superuser2
• TAM: tam1 / tam1
• TAM: tam2 / tam2
• Support: support1 / support1
• Support: support2 / support2
• Admin: admin / admin

Contributing

Contributions to billetsys are managed on GitHub.com

• Ask a question
• Raise an issue
• Feature request
• Code submission

Contributions are most welcome !

Please, consult our Code of Conduct policies for interacting in our community.

Consider giving the project a star on GitHub if you find it useful.

License

Eclipse Public License - v2.0