billetsys: Modern Support Ticket Solution
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
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
Sponsors
Contributing
Contributions to billetsys are managed on GitHub.com
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.