Skip to content
Alpine Linux based Factorio headless server Docker container
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Update Dockerfile,, documentation and examples Aug 24, 2018
examples Update Dockerfile,, documentation and examples Aug 24, 2018
stable Update scripting to resolve bug/enhancement request #5 Mar 8, 2019
.dockerignore Update Dockerfile,, documentation and examples Aug 24, 2018
.gitignore Update Dockerfile,, documentation and examples Aug 24, 2018 Bump experimental VERSION to 0.17.58 Jul 15, 2019
Makefile Updates for automation/building via Makefiles. Aug 16, 2017 Bump experimental VERSION to 0.17.58 Jul 15, 2019

Factorio Docker Container

Docker Build Status Docker Pulls Docker Stars MB Layers MB Commit MB License

Docker tags:

Tag Factorio Version Description Release Date
latest 0.16.51 Factorio headless server stable release 2018-08-24
experimental 0.17.58 Factorio headless server experimental release 2019-07-15
release-0.16.51 0.16.51 Factorio headless server stable static release 2018-06-19
release-0.15.40 0.15.40 Factorio headless server stable static release 2017-12-04

For security/attack surface reduction the container is configured to run the Factorio headless server with an internal user & group factorio having a pre-set UID & GID of 999. The container will attempt to adjust permissions on mapped volumes and data to match before dropping privileges to start the Factorio server processes. If the container is being run with a different Docker --user setting permissions may need to be fixed manually.

IE: chown -R 999:999 ./{config,mods,saves}

A custom UID and GID can be configured for the container internal factorio user and group. For more information see the "Environment variables" section in this document.

Always stop the existing container and make a VERIFIED backup copy of your Factorio save data before installing newer images.


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 storage location

The container exposes two ports:

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

The most basic way to run this container:

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

Recommended: run via Docker Compose:

Have the container store the config, mods and saves on a local file-system or in a specific, known data volume (recommended for persistence and troubleshooting) and expose the RCON port for admin:

version: '3'

    image: goofball222/factorio
    container_name: factorio
    restart: unless-stopped
      - "27015:27015"
      - "34197:34197/udp"
      - /etc/localtime:/etc/localtime:ro
      - ./config:/opt/factorio/config
      - ./mods:/opt/factorio/mods
      - ./saves:/opt/factorio/saves
      - TZ=UTC

Example basic docker-compose.yml file

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

Environment variables:

Variable Default Description
DEBUG false Set to true for extra container verbosity for debugging
FACTORIO_OPTS unset Add custom command line options to factorio server executable at runtime
FACTORIO_PORT unset Override server default port for game client connections
FACTORIO_RCON_PASSWORD unset Specifiy the server RCON password
FACTORIO_RCON_PORT 27015 Specifies the server RCON admin port
PGID 999 Specifies the GID for the container internal factorio group (used for file ownership)
PUID 999 Specifies the UID for the container internal factorio user (used for process and file ownership)
RUN_CHOWN true Set to false to disable the container automatic chown at startup. Speeds up startup process on overlay2 Docker hosts. NB/IMPORTANT: It's critical that you insure directory/data permissions on all mapped volumes are correct before disabling this or Factorio will not start.
RUNAS_UID0 false Set to true to force the container to run the Factorio server process as UID=0 (root) - NB/IMPORTANT: running with this set to "true" is insecure

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.

You can’t perform that action at this time.