Troubleshooting and FAQ
The most common errors, their cause and fix, and the questions that keep coming back.
- License errors: causes and fixesUnknown key, seats taken, trial already used, installation already claimed, domain not verifiable: what each message means and how to fix it.
- License or update server unreachableNothing shuts off right away: check the machine's outbound HTTPS access to lic1 and lic2.agorapanel.com, DNS and the firewall.
- Game database unreachable or refusedETIMEDOUT, ECONNREFUSED, Access denied, table not found, framework not detected, missing CREATE right: the connection test errors and their fix.
- Troubleshoot the Hub's built-in databaseMemory too small, disk full, "la base intégrée n'a pas démarré": the console messages when the Hub's database, installed inside your panel server, has a problem, and the fix for each.
- Discord: role not given, missing permission, bot role too lowWhen a role does not arrive, it is almost always the bot's role sitting below the role to give, or the Manage Roles permission missing.
- Discord sign-in fails (redirect_uri, no Administration)redirect_uri mismatch comes from a callback URL that does not match character for character; no Administration entry, from a sign-in made outside getting started.
- Two-factor authentication refused or "Check still needed"A staff member blocked by 2FA: turn it on in Discord, sign in again, and check the state seen at their last sign-in.
- Failed update and rolling backA failing update changes nothing, or returns to the previous version on its own; to undo the database too, restore the pre-update backup.
- Where to find an error's reference codeThe "This page could not be displayed" screen gives a reference code; panel errors carry a "ref."; the administrator finds them in Administration → Errors and the logs.
- Frequently asked questionsShort answers to the questions that keep coming back: hosting, key, domain, accounts, MDT, tablet, backups, license.
- A refund made at PayPal does not show up in AgoraA donation still "Received" or a sale still "Delivered" after a refund at PayPal: the PayPal webhook is not set up, or Agora refuses it.
- Report a bug or suggest an idea on our Discord/bug or right-click a message → Report bug: a post in the #bugs forum, tracked by the team. /suggestion for an idea.
- Report an error to Agora ("Report to Agora" button)From the error log, one click shows what will be sent (scrubbed), gives a support ID and opens a private, pre-filled ticket on Agora's Discord.