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

"Subscription required" banner in Community Oversight

You're on the monthly plan and your subscription has lapsed. Sign in to the customer portal, click Manage billing, and update your payment method or resubscribe. The banner clears within ~6 hours of the subscription becoming active again. See Subscription & Billing for details.

Lifetime customers should never see this banner — if you do, open a ticket in our Discord.

Container fails to start with LICENSE_KEY env var is not set

Your LICENSE_KEY is missing from .env. Sign in to the customer portal, download a fresh .env (your license is pre-filled), and copy the LICENSE_KEY line into your existing .env. 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
• Sign in to the portal → Discord server card → update to your new guild ID → you'll receive a new license

Still stuck?

Join our Discord and open a support ticket.