Menu
  Log out
 

Factorio Auth Token: Authenticating Headless Servers

Factorio Guide • Updated Feb 14, 2026

Factorio: Authentication Token Setup

To run a Public server or automatically download mods, your server needs to prove it owns a valid copy of the game. It does this via an Auth Token (not your account password).

1. Why use a Token?

Using your real password in a config file is a security risk. Tokens are revocable keys that allow the server to securely authenticate with Wube's services.

2. Mod Portal Access

Without a token, your server cannot download mods from the Mod Portal during startup. You would have to upload them manually.

3. Public Listing

Only authenticated servers can appear in the global Server Browser. Unverified servers are Direct Connect (IP) only.

Step-by-Step Guide

  1. Log in to your profile at Factorio.com.
  2. Scroll down to the "Service Token" section.
  3. Click Reveal next to your token.
  4. Copy the long string of random characters.

Applying the Token

You need to edit your server-settings.json file located in the /config/ directory.

  1. Open server-settings.json.
  2. Find the fields: username and token (sometimes labeled service_token).
  3. Enter your Factorio Username (not your email address).
  4. Enter the Token into the token field.
    Note: If you provide a token, you should leave the password field blank.
  5. Save the file and Restart the server.

Troubleshooting

  • Steam Users: If you bought the game on Steam, you must link your Steam account on the Factorio website to generate a token.
  • Spaces: Ensure you didn't copy a whitespace character at the end of the token string.
  • Verification: Set "require_user_verification": true to ensure players must also be logged in, preventing spoofing.

Verified production starts here. View plans.

← Back to Factorio Guides
Top