latest- highest version: may be experimental.
stable- highest version declared stable.
0.x- highest version in a branch: may be experimental.
0.x.y- a specific version.
0.x-dev- whatever is in master for that version.
What is Factorio?
Factorio is a game in which you build and maintain factories.
You will be mining resources, researching technologies, building infrastructure, automating production and fighting enemies. Use your imagination to design your factory, combine simple elements into ingenious structures, apply management skills to keep it working and finally protect it from the creatures who don't really like you.
The game is very stable and optimized for building massive factories. You can create your own maps, write mods in Lua or play with friends via Multiplayer.
Run the server to create the necessary folder structure and configuration files. For this example data is stored in
docker run -d -p 34197:34197/udp -p 27015:27015/tcp \ -v /tmp/factorio:/factorio \ --name factorio \ --restart=always \ dtandersen/factorio
For those new to Docker, here is an explanation of the options:
-d- Run as a daemon ("detached").
-p- Expose ports.
/tmp/factorioon the local file system to
/factorioin the container.
--restart- Restart the server if it crashes and at system start
--name- Name the container "factorio" (otherwise it has a funny random name).
Check the logs to see what happened:
docker logs factorio
Stop the server:
docker stop factorio
Now there's a
server-settings.json file in the folder
/tmp/factorio/config. Modify this to your liking and restart the server:
docker start factorio
Try to connect to the server. Check the logs if it isn't working.
To issue console commands to the server, start the server in interactive mode with
-it. Open the console with
docker attach and then type commands.
docker run -d -it \ --name factorio \ dtandersen/factorio docker attach factorio
Before upgrading backup the save. It's easy to make a save in the client.
-v was used to run the server so the save is outside of the Docker container. The
docker rm command completely destroys the container, which includes the save if it isn't stored in an data volume.
Delete the container and refresh the image:
docker stop factorio docker rm factorio docker pull dtandersen/factorio
Now run the server as before. In about a minute the new version of Factorio should be up and running, complete with saves and config!
A new map named
_autosave1.zip is generated the first time the server is started. The
map-settings.json files in
/tmp/factorio/config are used for the map settings. On subsequent runs the newest save is used.
To load an old save stop the server and run the command
touch oldsave.zip. This resets the date. Then restart the server. Another option is to delete all saves except one.
To generate a new map stop the server, delete all of the saves and restart the server.
Copy mods into the mods folder and restart the server.
Set the RCON password in the
rconpw file. A random password is generated if
rconpw doesn't exist.
To change the password, stop the server, modify
rconpw, and restart the server.
To "disable" RCON don't expose port 27015, i.e. start the server without
-p 27015:27015/tcp. RCON is still running, but nobody can to connect to it.
config/server-whitelist.json and add the whitelisted users.
[ "you", "friend" ]
The philosophy is to keep it simple.
- The server should bootstrap itself.
- Prefer configuration files over environment variables.
- Use one volume for data.
To keep things simple, the container uses a single volume mounted at
/factorio. This volume stores configuration, mods, and saves.
factorio |-- config | |-- map-gen-settings.json | |-- rconpw | |-- server-settings.json | `-- server-whitelist.json |-- mods | `-- fancymod.zip `-- saves `-- _autosave1.zip
34197/udp- Game server (required).
27015/tcp- RCON (optional).
PORT(0.15+) - Start the server on an alterate port, .e.g.
docker run -e "PORT=34198".
My server is listed in the server browser, but nobody can connect
Check the logs. If there is the line
Own address is RIGHT IP:WRONG PORT, then this could be caused by the Docker proxy. If the the IP and port is correct it's probably a port forwarding or firewall issue instead.
By default, Docker routes traffic through a proxy. The proxy changes the source UDP port, so the wrong port is detected. See the forum post Incorrect port detected for docker hosted server for details.
To fix the incorrect port, start the Docker service with the
--userland-proxy=false switch. Docker will route traffic with iptables rules instead of a proxy. Add the switch to the
DOCKER_OPTS environment variable or
ExecStart in the Docker systemd service definition. The specifics vary by operating system.
When I run a server on a port besides 34197 nobody can connect from the server browser
PORT environment variable to start the server on the a different port, .e.g.
docker run -e "PORT=34198". This changes the source port on the packets used for port detection.
-p 34198:34197 works fine for private servers, but the server browser detects the wrong port.
One problem I see with storing the config files in /tmp is many distributions flush this directory on boot. /usr/local/factorio or /opt/factorio would be better locations.
thanks four your work!
BTW: 0.15.6 is up at the latest version.
Any recommendations on cron jobs to automatically detect out of date?
I just want to leave a BIG "Thank You!" here for how fast you are keeping up with these experimental builds! Great work!
Thank you very much! This did just the trick!
I did not know you could use the -d and -it argument simultaneously. Good to know!
It worked for me when I started it with
-d -it then attach to it.
docker run -it -d \ -v /tmp/factorio:/factorio \ --name factorio \ dtandersen/factorio
This works just perfect and helped me get a 0.15 server up and running in no time!
But I still have a question: How do i access the server, as to write server commands, other than with RCON?
I have tried to run "docker exec factorio bash" and "docker attach factorio" in hope of accessing the container, but i can't seem to get it to work.
0.15 is up. Open an issue on github if there's any problems (I haven't tried it yet!)
Updated to 0.14.22. Thanks jaredledvina!
I could never enable --userland-proxy for docker. It doesn't show up for me and I didn't have to use it at all. I believe it's irrelevant now for factorio anyway. Just assign the ports with -p xxx:yyy/zzz and it should work just fine.