Troubleshooting

Login fails with "lack the authorization" error

Your Discord account does not have any of the required roles in the configured guild. Check DISCORD_REQUIRED_ROLE_IDS in your .env.

Caddy fails to get a TLS certificate

Ensure ports 80 and 443 are open in your firewall and that your domain's DNS has fully propagated (can take up to 48 hours, usually minutes).

OAuth redirect URI mismatch

Make sure the redirect URI in your Discord application exactly matches:

https://cad.yourcommunity.com/api/auth/callback/discord

No trailing slash. Must include https://.

Container keeps restarting

Check logs with docker compose logs backend. A missing required env var (like BASE_URL or BETTER_AUTH_SECRET) will cause an immediate crash.

In-game CAD does not open

• Confirm smart_cad_url is set and matches your BASE_URL (including https://)
• Confirm smart_api_key matches FIVEM_API_KEY in .env
• Ensure ox_lib starts before smart-ingame
• Check the server console for HTTP errors from the ingame resource

Container fails to start with LICENSE_KEY env var is not set

Your LICENSE_KEY is missing from .env. Contact us on Discord to get a new license key, then add it to your .env and restart with docker compose restart backend.

Container fails with License is not valid for this guild

Your license was issued for a different DISCORD_GUILD_ID than the one in your .env. Either:

• Update DISCORD_GUILD_ID in .env to match the guild your license is bound to, or
• Contact us on Discord to have your license reissued for your new guild ID

Still stuck?

Join our Discord and open a support ticket.