Add your factorio.com token to your Factorio server

Your Factorio server needs your factorio.com username and token for two jobs: downloading mods from the mod portal, and listing your server in Browse public games. You add them once in Settings, and the panel never shows the token again. This page explains what the token is, where to find it, and what it’s never used for.

What the token is

The token is a long code tied to your factorio.com account. The game uses it to talk to Factorio’s online services, so it doesn’t have to send your password each time. It is not your password.

Wube’s services ask for a username and token in two places that matter for a server:

What we use it for

Only these two jobs:

1. Downloading mods when you install or update them from the Mods tab. Our system fetches each file straight from the mod portal with your username and token.
2. Listing your server in Browse public games, when you turn public listing on. The game server signs in to Factorio’s list with your username and token.

What it’s never used for

• We never use it to sign in to factorio.com or change anything on your account.
• We never use it for another server, or for anyone else’s mods.
• We never ask for your factorio.com password. Support will never ask for your password or your token in a chat or email.
• The panel never shows it again, to you or to the friends you invite in Friends.

Find your token on factorio.com

1. Go to factorio.com and sign in. Bought it on Steam? Use the Steam sign-in option.
2. Open your profile page at factorio.com/profile.
3. Find your token. It’s hidden at first, so choose to reveal it.
4. Copy it. Note your username on the same page too. You need the username, not your email address.

Or find it on your PC

The game keeps your username and token in player-data.json, in your Factorio folder:

Open player-data.json in a text editor. Look for service-username and service-token. Copy the values between the quotes, without the quotes.

Add it to your server

1. Open your server in the panel and go to Settings.
2. Find the factorio.com username and token fields.
3. Paste your username and your token, and save.

The panel then shows that a token is set, but never shows it again. To change it, paste a new one over it. To turn on the public list too, see Join from Browse public games.

The manual way

The game itself reads the token from server-settings.json:

{
  "username": "your-factorio-username",
  "token": "your-token",
  "password": ""
}

Leave password empty. A token does the same job without exposing your password. Restart the server after you save.

Anyone who can open Files on your server can read that file. Only give Files access to friends you trust, and use the field in Settings unless you have a reason not to.

If the token stops working

Signs of a bad or old token:

• The Mods tab can’t download mods.
• Your server drops off Browse public games, or never appears there.
• In the game, players may see “There was a mismatch on the mod portal in verifying your username and token. Please log in again.” That one is about their own game’s sign-in, not your server’s.

To fix it:

1. Check you used your factorio.com username, not your email.
2. Get the current token from factorio.com/profile and paste it into Settings again.
3. Restart the server.

Did you reset your token on factorio.com? The old one stops working right away, everywhere. Paste the new one into Settings, and sign in again in your own game too.

If your token leaks

1. Sign in at factorio.com/profile and reset your token. The old one stops working.
2. Paste the new token into Settings in the panel.
3. Sign in again in your own game, since it was using the old token too.

Your saves, mods and server aren’t affected by a reset.