Get started

Free trial Try a game free for 3 days. No card needed. Start a free trial Start a free trial

Game servers

All games
Compare all games Try a game free for 3 days

Guides / Factorio / Mods and Space Age

Factorio mod portal account for server mod downloads

A Factorio server downloads mods with its own factorio.com account: set the username on Startup and the token under Passwords, not the password.

Updated , checked on Factorio 2.1.24

The mod portal only gives a download to someone signed in with a factorio.com account. Without one it sends you to a login page. So your server needs its own account: put the username on Startup, and the account’s token under Passwords in the Config Editor. The token is not the password.

The Mods page says it too: “Downloads from the mod portal need a factorio.com account: the username on Startup and its token under Passwords in the Config Editor.”

What you need

  • A factorio.com account that owns Factorio. An account that does not own the game is refused by the portal.
  • Its username.
  • Its token. It is shown on your profile at factorio.com/profile. It is not your password. Never type the account password into the panel.

Set the username

  1. Open Startup.
  2. Find factorio.com username.
  3. Type the username. Use letters, digits, dots, dashes and underscores, up to 60 characters.
  4. Save.
The Startup page's Variables section with the factorio.com username box and the note pointing to Passwords on the Config Editor
  1. Type the username
  2. Passwords are on the Config Editor

Set the token

  1. Open the Config Editor.
  2. Choose the source Passwords.
  3. Find factorio.com token.
  4. Paste the token. It may be letters and digits, up to 100.
  5. Save.
The Passwords source of the Config Editor with the Join password, factorio.com token and RCON password rows
  1. Passwords
  2. Paste the token

Passwords are never shown on Startup. That page points you to the Config Editor. The server writes the username and token into its settings file at every start, so edits you make to those two lines by hand in server-settings.json do not stay. Use the panel.

Then install

Go back to the Mods page and install a mod. See install mods. The panel uses the server’s own account when both the username and the token are set.

The restart is not needed for downloads, only for the server list below.

The same account lists the server

The username and token are also what a public server list needs. For that, restart the server after you save them, because they are written at every start. See the public server listing. One account does both jobs.

Uploading a mod

An uploaded mod file needs no account, because nothing is downloaded. Mods that the uploaded one needs are downloaded from the portal, and those do need the account.

If it does not work

  • “Downloads from the mod portal need a factorio.com account: set the server’s username on the Startup page and its token under Passwords on the Config Editor page”. One of the two is empty. Set both.
  • “factorio.com refused the server’s account: check the username on the Startup page and the token under Passwords on the Config Editor page”. The username or token is wrong, the token is really the password, or the account does not own Factorio. Copy the token again from factorio.com/profile.
  • You cannot see Passwords. Your role may not allow it.

More about the game: Factorio servers.

Sources: wiki.factorio.com: Mod portal API, mods.factorio.com

Factorio serversAll Factorio guides