Home

Ticket-Bot is an open-source Discord ticket bot for running private support channels in your server. This wiki documents the current v4 codebase and focuses on self-hosted setup, configuration, day-to-day operation, and customization.

If you used the older v3 documentation at https://doc.ticket.pm/, treat it as historical reference only. The v4 project uses a TypeScript config file, Bun-based scripts, ticket.pm transcript uploads, and a different message-template system.

What Ticket-Bot Does

• Creates private Discord ticket channels from configurable panels.
• Supports multiple ticket types, each with its own category, staff roles, blocked roles, welcome text, and optional opening form.
• Provides staff workflows for claiming, unclaiming, closing, renaming, deleting, and adding or removing users.
• Can DM users when tickets close.
• Can generate ticket transcripts through ticket.pm.
• Can send audit logs for ticket actions.
• Can run locally with Bun or in Docker.

Start Here

New installations should follow these pages in order:

1. Creating a Discord Bot
2. Quick Start
3. Installation
4. Configuration
5. Panels

If you already have the bot running, the most useful reference pages are:

• Commands
• Ticket Types and Forms
• Claims and Closing
• Custom Messages
• Troubleshooting

Important License Notice

Ticket-Bot is licensed under AGPL-3.0-only with an additional attribution term. You must keep a visible notice that the software is powered by Ticket-Bot, including a link to the original project repository or website.

The default config already includes a status text like:

text: "Powered by git.new/ticketbot"

The bot also attempts to add Powered by https://git.new/ticketbot to the application description. Do not remove, hide, or replace this attribution.

Support

• Repository: https://github.com/Sayrix/Ticket-Bot
• Discord support server: https://discord.gg/VasYV6MEJy
• Sponsors: https://github.com/sponsors/Sayrix