Public | Automated Build

Last pushed: 19 days ago
Short Description
Factorio headless server
Full Description

Factorio Docker Container

Docker tags:

Tag Factorio Version Description Release Date
latest 0.15.34 Factorio headless server stable release 2017-09-06
experimental 0.15.34 Factorio headless server experimental release 2017-08-23
release-0.15.34 0.15.34 Factorio headless server stable static release 2017-08-14
release-0.14.23 0.14.23 Factorio headless server stable static release 2017-04-24

Always stop the existing container and make a backup copy of your Factorio data before installing newer images.
Make a backup of your v0.14.X saves before upgrading to v0.15.X. A lot has changed and may break existing maps/saves.


This container is configured to look for the file in /opt/factorio/saves,
mods in /opt/factorio/mods, and server/map generation settings in /opt/factorio/config.

Logs are available directly from the running container, IE: "docker logs factorio"

The most basic way to launch this container is as follows:

$ docker run --init --name factorio -d \
    -p 34197:34197/udp \

The container exposes two ports:

  • 27015/tcp: Factorio RCON port
  • 34197/udp: Factorio default server port

The container exposes three volumes:

  • /opt/factorio/config - Factorio headless server config files
  • /opt/factorio/mods - Factorio mods default directory for non-standard add-ins
  • /opt/factorio/saves - Factorio save/map file default storage location

The container has 3 ENV (-e/--env) variables that can be set:

  • DEBUG sets "-x" in factorio-init for debugging, defaults to false. Set to true to activate.
  • FACTORIO_RCON_PASSWORD sets the RCON password.
  • FACTORIO_OPTS feed additional command line options to factorio server executable at runtime.

To have the container store the config, mods and saves (recommended for persistence)
and expose the RCON port for admin, run:

$ docker run --init --name factorio -d \
    -p 27015:27015 -p 34197:34197/udp \
    -v /DATA_VOLUME/factorio/config:/opt/factorio/config \
    -v /DATA_VOLUME/factorio/mods:/opt/factorio/mods \
    -v /DATA_VOLUME/factorio/saves:/opt/factorio/saves \

Example docker-compose.yml file for use with Docker Compose

version: '2.2'
    image: "goofball222/factorio:latest"
    init: true
     - "27015:27015"
     - "34197:34197/udp"
     - /DATA_VOLUME/factorio/config:/opt/factorio/config
     - /DATA_VOLUME/factorio/mods:/opt/factorio/mods
     - /DATA_VOLUME/factorio/saves:/opt/factorio/saves

During the first launch of the container the server-settings.json and map-gen-settings.json config files will be populated with the Factorio sample/defaults if they don't already exist. It is highly recommended to edit these files and relaunch the container afterwards or provide pre-setup copies in the config directory prior to first launch. The config sample files are available in the headless server tar.gz file in the "data" folder. The container will also generate a default map / in the saves folder if one is not found on launch.

The RCON password can be set via the FACTORIO_RCON_PASSWORD ENV flag or loaded from /opt/factorio/config/RCON.pwd each time the container is started. If the FACTORIO_RCON_PASSWORD ENV var is not set or the RCON.pwd file is not present a random RCON password will be generated and saved in /opt/factorio/config/RCON.pwd. The active RCON password can also be found at the start of the container log file at each launch.

Docker Pull Command
Source Repository

Comments (0)