FAQ & troubleshooting#

The first-run wizard says "invalid setup token" — or how do I set up remotely?#

The wizard's save is protected by a one-time token, so a freshly installed panel that happens to be reachable from the internet can't be taken over by a stranger. On the machine running the manager it's automatic. From another machine, read the token from the manager's console window and open http://<host>:<port>/admin/?setup_token=<token>. The token changes on every manager restart.

"Login with Discord" keeps asking me to authorize#

That's Discord's consent screen — it appears only the first time; returning users skip it. If it keeps repeating, you're probably being logged out between visits (see the next item).

I keep getting logged out of the Field Console#

Sessions survive manager restarts, so check the cookie flags for your setup: web.cookieSecure must be true only when you actually serve HTTPS (and false over plain HTTP), and behind a reverse proxy set web.trustProxy: true.

The Discord login button is missing#

Set DISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET and DISCORD_OAUTH_REDIRECT (admin → Discord section), and make sure the redirect URI exactly matches the one registered in the Discord Developer Portal. The button hides itself while OAuth is unconfigured.

My Stats says "no SCUM character linked"#

You're logged in with Discord but haven't linked a character yet. Run /link-account in Discord and type the connect:CODE into the in-game chat — see Discord bot.

A ban isn't taking effect#

Bans are written to the game's BannedUsers.ini, which SCUM reads at startup — a ban or unban applies after the next server restart. See Players & bans.

Leaderboards or a stat category are empty#

If a category shows nothing, no player has a non-zero value for it yet — new saves start empty.

Stats or economy look a little stale#

By design: leaderboards refresh every ~60 s, the overview is cached ~15 s, and trader funds update when a player actually trades. This keeps the load on your game database near zero.

I'm getting HTTP 429 (rate limited)#

The public and player APIs are rate-limited per IP. Behind a reverse proxy set web.trustProxy: true, so every visitor is counted separately instead of everyone sharing the proxy's IP.

The server won't start#

• The manager must run as administrator (the exe self-elevates — don't block the UAC prompt).
• Check the application log: data/SCUM-Server-Automation.log.
• Verify the server directory and launch arguments in the Server section.

The Live Map / Bridge / plugins say "premium required"#

Those features need an active Premium subscription. The in-game actions additionally need the game server running with the SSA Bridge deployed.

Where are the logs and data?#

• data/SCUM-Server-Automation.log — the manager's application log
• data/ — the manager's own databases (admins, links, bans, kill feed, trades, …)
• your SCUM save is only ever opened read-only — the manager never writes into it

Still stuck? Ask on Discord — Premium subscribers get priority support.