factorio-docker/README.md

349 lines
13 KiB
Markdown
Raw Normal View History

# Factorio [![](https://images.microbadger.com/badges/image/factoriotools/factorio.svg)](https://microbadger.com/images/factoriotools/factorio "Get your own image badge on microbadger.com") [![Docker Pulls](https://img.shields.io/docker/pulls/factoriotools/factorio.svg)](https://hub.docker.com/r/factoriotools/factorio/) [![Docker Stars](https://img.shields.io/docker/stars/factoriotools/factorio.svg)](https://hub.docker.com/r/factoriotools/factorio/)
2016-04-15 07:45:25 +02:00
2019-05-15 13:07:30 +02:00
* `0.17.39`, `0.17`, `latest` [(0.17/Dockerfile)](https://github.com/factoriotools/factorio-docker/blob/master/0.17/Dockerfile)
* `0.16.51`, `0.16`, `stable` [(0.16/Dockerfile)](https://github.com/factoriotools/factorio-docker/blob/master/0.16/Dockerfile)
* `0.15.40`, `0.15` [(0.15/Dockerfile)](https://github.com/factoriotools/factorio-docker/blob/master/0.15/Dockerfile)
* `0.14.23`, `0.14` [(0.14/Dockerfile)](https://github.com/factoriotools/factorio-docker/blob/master/0.14/Dockerfile)
2016-10-27 20:30:19 +02:00
2017-04-26 21:31:08 +02:00
*Tag descriptions*
2016-11-25 04:46:21 +01:00
2019-02-26 23:51:16 +01:00
* `latest` - most up-to-date version (may be experimental).
* `stable` - version declared stable on [factorio.com](https://www.factorio.com).
* `0.x` - latest version in a branch.
2016-11-25 04:47:53 +01:00
* `0.x.y` - a specific version.
2017-04-24 20:31:04 +02:00
* `0.x-dev` - whatever is in master for that version.
2016-11-25 04:45:05 +01:00
2017-04-24 21:45:04 +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
Run the server to create the necessary folder structure and configuration files. For this example data is stored in `/opt/factorio`.
2016-10-25 20:59:50 +02:00
```
2017-12-31 05:33:05 +01:00
sudo mkdir -p /opt/factorio
sudo chown 845:845 /opt/factorio
sudo docker run -d \
-p 34197:34197/udp \
-p 27015:27015/tcp \
-v /opt/factorio:/factorio \
2016-11-03 16:02:43 +01:00
--name factorio \
--restart=always \
factoriotools/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").
2016-11-04 21:21:30 +01:00
* `-p` - Expose ports.
* `-v` - Mount `/opt/factorio` on the local file system to `/factorio` in the container.
2016-11-03 16:02:43 +01:00
* `--restart` - Restart the server if it crashes and at system start
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
2017-12-31 05:33:05 +01:00
The `chown` command is needed because in 0.16+, we no longer run the game server as root for security reasons, but rather as a 'factorio' user with user id 845. The host must therefore allow these files to be written by that user.
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
Now there's a `server-settings.json` file in the folder `/opt/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
2017-04-26 00:26:32 +02:00
## Console
2017-04-26 21:29:43 +02:00
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.
2017-04-26 00:26:32 +02:00
docker run -d -it \
--name factorio \
factoriotools/factorio
2017-04-26 00:26:32 +02:00
docker attach factorio
2017-04-26 21:29:43 +02:00
## Upgrading
Before upgrading backup the save. It's easy to make a save in the client.
Ensure `-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 factoriotools/factorio
2017-04-26 21:29:43 +02:00
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!
2016-10-25 20:59:50 +02:00
## Saves
A new map named `_autosave1.zip` is generated the first time the server is started. The `map-gen-settings.json` and `map-settings.json` files in `/opt/factorio/config` are 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
## Scenarios
If you want to launch a scenario from a clean start (not from a saved map) you'll need to start the docker image from an alternate entrypoint. To do this, use the example entrypoint file stored in the /factorio/entrypoints directory in the volume, and launch the image with the following syntax. Note that this is the normal syntax with the addition of the --entrypoint setting AND the additional argument at the end, which is the name of the Scenario in the Scenarios folder.
```
docker run -d \
-p 34197:34197/udp \
-p 27015:27015/tcp \
-v /opt/factorio:/factorio \
--name factorio \
--restart=always \
--entrypoint "/scenario.sh" \
factoriotools/factorio \
MyScenarioName
```
## Converting Scenarios to Regular Maps
If you would like to export your scenario to a saved map, you can use the example entrypoint similar to the Scenario usage above. Factorio will run once, converting the Scenario to a saved Map in your saves directory. A restart of the docker image using the standard options will then load that map, just as if the scenario were just started by the Scenarios example noted above.
```
docker run -d \
-p 34197:34197/udp \
-p 27015:27015/tcp \
-v /opt/factorio:/factorio \
--name factorio \
--restart=always \
--entrypoint "/scenario2map.sh" \
factoriotools/factorio
MyScenarioName
```
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.
2017-04-26 21:29:43 +02:00
To change the password, stop the server, modify `rconpw`, and restart the server.
2016-10-31 21:15:24 +01:00
2017-04-26 21:29:43 +02:00
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.
2016-10-27 20:30:19 +02:00
## Whitelisting (0.15.3+)
Create file `config/server-whitelist.json` and add the whitelisted users.
[
"you",
"friend"
]
2019-02-27 02:30:47 +01:00
## Banlisting (0.17.1+)
Create file `config/server-banlist.json` and add the banlisted users.
[
"bad_person",
"other_bad_person"
]
2019-02-27 02:26:59 +01:00
## Adminlisting (0.17.1+)
Create file `config/server-adminlist.json` and add the adminlisted users.
[
"you",
"friend"
]
2019-03-05 14:05:49 +01:00
## Customize configuration files (0.17.x+)
2019-03-05 13:05:27 +01:00
2019-03-05 13:08:21 +01:00
Out-of-the box, factorio does not support environment variables inside the configuration files. A workaround is the usage of `envsubst` which generates the configuration files dynamically during startup from environment variables set in docker-compose:
2019-03-05 13:05:27 +01:00
2019-03-05 13:08:21 +01:00
Example which replaces the server-settings.json:
2019-03-05 13:05:27 +01:00
factorio_1:
image: factoriotools/factorio
2019-03-05 13:05:27 +01:00
ports:
- "34197:34197/udp"
volumes:
- /opt/factorio:/factorio
- ./server-settings.json:/server-settings.json
environment:
- INSTANCE_NAME=Your Instance's Name
- INSTANCE_DESC=Your Instance's Description
2019-03-05 14:05:49 +01:00
entrypoint: /bin/sh -c "mkdir -p /factorio/config && envsubst < /server-settings.json > /factorio/config/server-settings.json && exec /docker-entrypoint.sh"
2019-03-05 13:05:27 +01:00
The `server-settings.json` file may then contain the variable references like this:
"name": "${INSTANCE_NAME}",
"description": "${INSTANCE_DESC}",
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
2019-03-01 17:43:50 +01:00
The files in this volume should be owned by the factorio user, uid 845.
2016-10-27 20:30:19 +02:00
factorio
|-- config
2016-10-31 21:07:26 +01:00
| |-- map-gen-settings.json
| |-- map-settings.json
2016-10-31 21:07:26 +01:00
| |-- rconpw
| |-- server-adminlist.json
2019-02-27 02:30:47 +01:00
| |-- server-banlist.json
| |-- server-settings.json
| `-- server-whitelist.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
2017-12-31 05:33:05 +01:00
## Docker Compose
2017-12-31 05:40:58 +01:00
[Docker Compose](https://docs.docker.com/compose/install/) is an easy way to run Docker containers.
2019-05-15 13:07:30 +02:00
First get a [docker-compose.yml](https://github.com/factoriotools/factorio-docker/blob/master/0.17/docker-compose.yml) file. To get it from this repository:
2017-12-31 05:40:58 +01:00
2017-12-31 05:33:05 +01:00
```
2019-05-15 13:07:30 +02:00
git clone https://github.com/factoriotools/factorio-docker.git
cd docker_factorio_server/0.17
2017-12-31 05:40:58 +01:00
```
Or make your own:
```
version: '2'
services:
factorio:
image: factoriotools/factorio
2017-12-31 05:40:58 +01:00
ports:
- "34197:34197/udp"
- "27015:27015/tcp"
volumes:
- /opt/factorio:/factorio
```
Now cd to the directory with docker-compose.yml and run:
```
2017-12-31 05:33:05 +01:00
sudo mkdir -p /opt/factorio
sudo chown 845:845 /opt/factorio
sudo docker-compose up -d
```
2017-12-31 06:07:06 +01:00
2016-10-25 18:58:54 +02:00
## Ports
2016-04-15 07:54:17 +02:00
2017-04-27 17:32:07 +02:00
* `34197/udp` - Game server (required).
2016-10-27 20:30:19 +02:00
* `27015/tcp` - RCON (optional).
2016-04-15 07:23:36 +02:00
2017-04-24 21:45:04 +02:00
## Environment Variables
* `PORT` (0.15+) - Start the server on an alternate port, .e.g. `docker run -e "PORT=34198"`.
* `RCON_PORT` (0.16+) - Start the RCON on an alternate port, .e.g. `docker run -e "RCON_PORT=34198"`.
2017-04-24 21:45:04 +02:00
2017-12-31 06:07:06 +01:00
## LAN Games
Ensure the `lan` setting in server-settings.json is `true`.
```
"visibility":
{
"public": false,
"lan": true
},
```
Start the container with the `--network=host` option so clients can automatically find LAN games. Refer to the Quick Start to create the `/opt/factorio` directory.
```
sudo docker run -d \
--network=host \
-p 34197:34197/udp \
-p 27015:27015/tcp \
-v /opt/factorio:/factorio \
--name factorio \
--restart=always \
factoriotools/factorio
2017-12-31 06:07:06 +01:00
```
2019-03-01 17:43:50 +01:00
## Vagrant
[Vagrant](https://www.vagrantup.com/) is a easy way to setup a virtual machine (VM) to run Docker. The [Factorio Vagrant box repository](https://github.com/dtandersen/factorio-lan-vagrant) contains a sample Vagrantfile.
For LAN games the VM needs an internal IP in order for clients to connect. One way to do this is with a public network. The VM uses DHCP to acquire an IP address. The VM must also forward port 34197.
2017-12-31 06:07:06 +01:00
```
config.vm.network "public_network"
config.vm.network "forwarded_port", guest: 34197, host: 34197
```
2019-04-28 03:05:44 +02:00
## Amazon Web Services (AWS) Deployment
If you're looking for a simple way to deploy this to the Amazon Web Services Cloud, check out the [Factorio Server Deployment (CloudFormation) repository](https://github.com/m-chandler/factorio-spot-pricing). This repository contains a CloudFormation template that will get you up and running in AWS in a matter of minutes. Optionally it uses Spot Pricing so the server is very cheap, and you can easily turn it off when not in use.
2016-10-27 20:44:05 +02:00
## Troubleshooting
2016-11-03 08:50:03 +01:00
**My server is listed in the server browser, but nobody can connect**
2016-10-27 20:44:05 +02:00
2016-11-03 08:50:03 +01:00
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.
2016-11-03 00:40:27 +01:00
2016-11-03 08:50:03 +01:00
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](https://forums.factorio.com/viewtopic.php?f=49&t=35255)* for details.
2016-11-02 23:37:22 +01:00
2016-11-03 08:41:04 +01:00
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.
2016-10-27 20:44:05 +02:00
2017-04-24 20:24:19 +02:00
**When I run a server on a port besides 34197 nobody can connect from the server browser**
2017-04-24 21:45:04 +02:00
Use the `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.
2016-10-27 20:44:05 +02:00
# Contributors
2016-10-27 20:30:19 +02:00
2019-05-15 13:07:30 +02:00
* [dtandersen](https://github.com/dtandersen) - Maintainer
2018-03-12 18:33:05 +01:00
* [Fank](https://github.com/Fankserver/docker-factorio-watchdog) - Keeper of the Factorio watchdog that keeps the version up-to-date.
2019-03-04 20:00:12 +01:00
* [DBendit](https://github.com/DBendit/docker_factorio_server) - Admin list, ban list, version updates
* [Zopanix](https://github.com/zopanix/docker_factorio_server) - Originator
2017-04-26 22:09:29 +02:00
* [Rfvgyhn](https://github.com/Rfvgyhn/docker-factorio) - Randomly generate RCON password
* [gnomus](https://github.com/gnomus/docker_factorio_server) - White listing
2018-03-12 18:33:05 +01:00
* [bplein](https://github.com/bplein/docker_factorio_server) - Scenario support
2017-04-26 22:09:29 +02:00
* [jaredledvina](https://github.com/jaredledvina/docker_factorio_server) - Version update