LEO TOOLKIT
LEO TOOLKIT Troubleshooting
Diagnose backend, environment, spreadsheet, role, nickname, authentication, and command-sync problems.
Common problems#
| Problem | Resolution |
|---|---|
| Bot starts but spreadsheet commands fail | Test TOOLBOX_API_BASE_URL, backend health, shared secret, and required routes. |
| /department test fails | Confirm spreadsheet ID, tab names, sheet sharing, service-account access, and backend logs. |
| Environment variable missing | Use the exact variable name, remove accidental spaces, and restart. |
| Cannot assign rank role | Move the bot role above the rank and grant Manage Roles. |
| Cannot change nickname | Grant Manage Nicknames and ensure the target member is below the bot role. |
| Protected API authentication fails | Make TOOLBOX_BOT_API_SECRET identical on bot and backend; do not use the Discord token. |
| Commands do not appear | Use TOOLBOX_SYNC_GUILD_ID during setup or wait for global synchronization. |