factorio-docker/README.md

127 lines
4.8 KiB
Markdown
Raw Normal View History

2016-10-27 20:49:22 +02:00
# Factorio [![Docker Pulls](https://img.shields.io/docker/pulls/dtandersen/factorio.svg)](https://hub.docker.com/r/dtandersen/factorio/) [![Docker Stars](https://img.shields.io/docker/stars/dtandersen/factorio.svg)](https://hub.docker.com/r/dtandersen/factorio/)
2016-04-15 07:45:25 +02:00
2016-11-03 01:50:00 +01:00
* `0.14.18`, `0.14`, `latest` [(0.14.18/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/0.14.18/0.14/Dockerfile)
* `0.14.17` [(0.14.17/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/0.14.17/0.14/Dockerfile)
2016-10-28 01:07:35 +02:00
* `0.14.16` [(0.14.16/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/0.14.16/0.14/Dockerfile)
2016-11-01 22:01:30 +01:00
* `0.13.20`, `0.13`, `stable` [(0.13.20/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/0.13.20/0.13/Dockerfile)
2016-10-27 20:30:19 +02:00
2016-04-15 07:48:52 +02:00
# What is Factorio?
2016-04-15 07:37:25 +02:00
[Factorio](https://www.factorio.com) 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.
2016-10-27 21:27:42 +02:00
NOTE: This is only the server. The game is available at [factorio.com](https://www.factorio.com) and [Steam](http://store.steampowered.com/app/427520/).
2016-03-24 08:39:16 +01:00
2016-10-27 20:30:19 +02:00
2016-10-27 01:56:00 +02:00
# Usage
2016-04-15 07:48:52 +02:00
## Quick Start
2016-10-27 20:30:19 +02:00
Run the server to create the necessary folder structure and configuration files. For this example data is stored in `/tmp/factorio`.
2016-10-25 20:59:50 +02:00
```
2016-10-27 01:41:54 +02:00
docker run -d -P -v /tmp/factorio:/factorio --name factorio dtandersen/factorio
2016-10-25 20:59:50 +02:00
```
2016-10-27 20:30:19 +02:00
For those new to Docker, here is an explanation of the options:
2016-10-27 01:30:32 +02:00
2016-10-27 20:30:19 +02:00
* `-d` - Run as a daemon ("detached").
* `-P` - Expose all ports.
* `-v` - Mount `/tmp/factorio` on the local file system to `/factorio` in the container.
2016-10-27 20:36:55 +02:00
* `--name` - Name the container "factorio" (otherwise it has a funny random name).
2016-10-25 20:59:50 +02:00
2016-10-27 01:41:54 +02:00
Check the logs to see what happened:
2016-03-04 15:50:01 +01:00
2016-03-27 08:56:09 +02:00
```
2016-10-27 01:41:54 +02:00
docker logs factorio
2016-03-27 08:56:09 +02:00
```
2016-04-15 07:54:17 +02:00
2016-10-27 01:41:54 +02:00
Stop the server:
2016-10-27 01:30:32 +02:00
2016-10-27 02:36:00 +02:00
```
docker stop factorio
```
2016-10-27 01:41:54 +02:00
2016-10-27 20:30:19 +02:00
Now there's a `server-settings.json` file in the folder `/tmp/factorio/config`. Modify this to your liking and restart the server:
2016-10-27 01:41:54 +02:00
2016-10-27 02:36:00 +02:00
```
docker start factorio
```
2016-10-27 01:41:54 +02:00
Try to connect to the server. Check the logs if it isn't working.
2016-10-25 19:28:04 +02:00
2016-10-27 20:30:19 +02:00
2016-10-25 20:59:50 +02:00
## Saves
2016-10-31 21:28:13 +01:00
A new map named `_autosave1.zip` is generated the first time the server is started. The `map-gen-settings.json` file in `/tmp/factorio/config` is used for the map settings. On subsequent runs the newest save is used.
2016-10-27 01:46:21 +02:00
2016-10-31 21:30:08 +01:00
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.
2016-10-27 01:30:32 +02:00
2016-10-27 20:36:55 +02:00
To generate a new map stop the server, delete all of the saves and restart the server.
2016-10-27 20:30:19 +02:00
2016-10-25 20:59:50 +02:00
## Mods
2016-10-27 20:36:55 +02:00
Copy mods into the mods folder and restart the server.
2016-10-25 19:28:04 +02:00
2016-10-27 20:30:19 +02:00
2016-10-31 21:07:26 +01:00
## RCON
2016-10-27 20:30:19 +02:00
2016-10-31 21:07:26 +01:00
Set the RCON password in the `rconpw` file. A random password is generated if `rconpw` doesn't exist.
2016-10-31 21:15:24 +01:00
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 with `-p 34197:34197/udp` instead of `-P`. RCON still runs, but nobody is able to connect to it.
2016-10-27 20:30:19 +02:00
2016-10-27 01:56:00 +02:00
# Container Details
2016-11-02 20:20:47 +01:00
The philosophy is to [keep it simple](http://wiki.c2.com/?KeepItSimple).
2016-10-27 21:27:42 +02:00
2016-11-02 20:20:47 +01:00
* The server should bootstrap itself.
2016-10-27 21:27:42 +02:00
* Prefer configuration files over environment variables.
* Use one volume for data.
2016-10-25 18:58:54 +02:00
## Volumes
2016-04-15 07:48:52 +02:00
2016-10-27 21:27:42 +02:00
To keep things simple, the container uses a single volume mounted at `/factorio`. This volume stores configuration, mods, and saves.
2016-10-27 20:30:19 +02:00
factorio
|-- config
2016-10-31 21:07:26 +01:00
| |-- map-gen-settings.json
| |-- rconpw
2016-10-31 21:20:47 +01:00
| `-- server-settings.json
2016-10-27 20:30:19 +02:00
|-- mods
2016-10-31 21:20:47 +01:00
| `-- fancymod.zip
`-- saves
2016-11-01 18:15:18 +01:00
`-- _autosave1.zip
2016-10-27 01:30:32 +02:00
2016-04-15 07:48:52 +02:00
2016-10-25 18:58:54 +02:00
## Ports
2016-04-15 07:54:17 +02:00
2016-10-27 20:30:19 +02:00
* `34197/udp` - Factorio clients (required).
* `27015/tcp` - RCON (optional).
2016-04-15 07:23:36 +02:00
2016-10-27 20:44:05 +02:00
## Troubleshooting
**Server is listed in the in-game server browser, but users can't connect**
2016-11-03 00:48:00 +01:00
If the logs say `Own address is RIGHT IP:WRONG PORT`, then this could be the problem.
2016-11-03 00:40:27 +01:00
2016-11-03 00:48:00 +01:00
By default, Docker routes outbound traffic through a proxy. The proxy changes the source UDP port, so the server list detects the wrong port. See [Incorrect port detected for docker hosted server](https://forums.factorio.com/viewtopic.php?f=49&t=35255).
2016-11-02 23:37:22 +01:00
2016-11-03 00:48:00 +01:00
To fix this port problem, start the Docker service with the `--userland-proxy=false` switch. This tells Docker to use iptables rules instead of a proxy. Add the switch to the `DOCKER_OPTS` variable or `ExecStart` in the Docker systemd service definition. The location of these files varies by OS.
2016-10-27 20:44:05 +02:00
2016-04-15 07:48:52 +02:00
# Credits
2016-04-15 07:23:36 +02:00
2016-10-27 20:30:19 +02:00
Ideas borrowed from:
* [Zopanix](https://github.com/zopanix/docker_factorio_server)
* [Rfvgyhn](https://github.com/Rfvgyhn/docker-factorio)