Troubleshooting

Where to look when something misbehaves. Most problems come from missing permissions or a category that isn't linked to a Discord location.

Read the console first

The bot logs the specific cause of most failures — for example which permission is missing in which channel, or that MySQL failed and it fell back to SQLite. Members only see a generic message.

Common errors

Symptom	Likely cause	Fix
"I was unable to create the ticket channel"	Bot lacks Manage Channels (or Create Private Threads) on the category	Grant it on the target category. The console names the exact channel.
"The selected ticket category is misconfigured"	Category isn't linked to a Discord category	Dashboard → Manage Categories → 📁 Set Category Channel.
Thread tickets fail with a text-channel message	Thread categories need a text channel, not a Discord category	Use 💬 Set Parent Channel and pick a text channel.
"Failed to generate transcript"	Bot can't read the channel's history	Grant Read Message History.
Missing Permissions	Bot role too low or missing a flag	Move the role higher or grant the permission.
Panel doesn't reflect dashboard changes	Panel is only updated on deploy	Click Deploy Ticket Panel again.
Unexpected empty data after a restart	MySQL failed and the bot fell back to SQLite	Fix the DB_* settings and restart.

For more, see Common Issues.