Merge pull request #24 from bkuhl/update-v0.15.11-experimental

Update to v0.15.11-experimental

0.15/Dockerfile

@@ -1,24 +1,26 @@
-FROM frolvlad/alpine-glibc:alpine-3.4
+FROM frolvlad/alpine-glibc:alpine-3.5
 
 MAINTAINER https://github.com/dtandersen/docker_factorio_server
 
-ENV VERSION=0.14.22 \
-    SHA1=c43fa0d750e8347ec466ce165053db3cd3dc2fe0
+ENV PORT=34197 \
+    VERSION=0.15.11 \
+    SHA1=bf20dc746f49f13684c91558b99aa3e14e6da2c5
 
 RUN mkdir /opt && \
-    apk --no-cache add curl tini pwgen && \
+    apk add --update --no-cache tini pwgen && \
+    apk add --update --no-cache --virtual .build-deps curl && \
     curl -sSL https://www.factorio.com/get-download/$VERSION/headless/linux64 \
-        -o /tmp/factorio_headless_x64_$VERSION.tar.gz && \
-    echo "$SHA1  /tmp/factorio_headless_x64_$VERSION.tar.gz" | sha1sum -c && \
-    tar xzf /tmp/factorio_headless_x64_$VERSION.tar.gz --directory /opt && \
-    rm /tmp/factorio_headless_x64_$VERSION.tar.gz && \
-    apk del curl && \
+        -o /tmp/factorio_headless_x64_$VERSION.tar.xz && \
+    echo "$SHA1  /tmp/factorio_headless_x64_$VERSION.tar.xz" | sha1sum -c && \
+    tar xf /tmp/factorio_headless_x64_$VERSION.tar.xz --directory /opt && \
+    rm /tmp/factorio_headless_x64_$VERSION.tar.xz && \
     ln -s /factorio/saves /opt/factorio/saves && \
-    ln -s /factorio/mods /opt/factorio/mods
+    ln -s /factorio/mods /opt/factorio/mods && \
+    apk del .build-deps
 
 VOLUME /factorio
 
-EXPOSE 34197/udp 27015/tcp
+EXPOSE $PORT/udp 27015/tcp
 
 COPY ./docker-entrypoint.sh /
 

0.15/docker-entrypoint.sh

@@ -31,5 +31,6 @@ exec /opt/factorio/bin/x64/factorio \
   --port $PORT \
   --start-server-load-latest \
   --server-settings $CONFIG/server-settings.json \
+  --server-whitelist $CONFIG/server-whitelist.json \
   --rcon-port 27015 \
   --rcon-password "$(cat $CONFIG/rconpw)"

0.15/start.sh

@@ -0,0 +1,5 @@
+sudo docker run -d -p 34197:34197/udp -p 27015:27015/tcp \
+  -v factorio:/factorio \
+  --name factorio \
+  --restart=always  \
+  factorio

README.md

@@ -1,14 +1,17 @@
-# 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/)
+# Factorio [![](https://images.microbadger.com/badges/image/dtandersen/factorio.svg)](https://microbadger.com/images/dtandersen/factorio "Get your own image badge on microbadger.com") [![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/)
 
-* `0.14.23`, `0.14`, `latest`, `stable` [(0.14/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/master/0.14/Dockerfile)
+* `0.15.11`, `0.15`, `latest` [(0.15/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/master/0.15/Dockerfile)
+* `0.14.23`, `0.14`, `stable` [(0.14/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/master/0.14/Dockerfile)
 * `0.13.20`, `0.13`  [(0.13/Dockerfile)](https://github.com/dtandersen/docker_factorio_server/blob/master/0.13/Dockerfile)
 
-*Tag philosophy*
+*Tag descriptions*
 
 * `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?
 
@@ -64,6 +67,31 @@ docker start factorio
 Try to connect to the server. Check the logs if it isn't working.
 
 
+## Console
+
+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
+
+
+## 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 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!
+
+
 ## Saves
 
 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.
@@ -82,11 +110,20 @@ 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 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.
+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.
 
 
+## Whitelisting (0.15.3+)
+
+Create file `config/server-whitelist.json` and add the whitelisted users.
+
+    [
+		"you",
+		"friend"
+	]
+
 # Container Details
 
 The philosophy is to [keep it simple](http://wiki.c2.com/?KeepItSimple).
@@ -104,7 +141,8 @@ To keep things simple, the container uses a single volume mounted at `/factorio`
     |-- config
     |   |-- map-gen-settings.json
     |   |-- rconpw
-    |   `-- server-settings.json
+    |   |-- server-settings.json
+    |   `-- server-whitelist.json
     |-- mods
     |   `-- fancymod.zip
     `-- saves
@@ -113,10 +151,15 @@ To keep things simple, the container uses a single volume mounted at `/factorio`
 
 ## Ports
 
-* `34197/udp` - Factorio clients (required).
+* `34197/udp` - Game server (required).
 * `27015/tcp` - RCON (optional).
 
 
+## Environment Variables
+
+* `PORT` (0.15+) - Start the server on an alterate port, .e.g. `docker run -e "PORT=34198"`.
+
+
 ## Troubleshooting
 
 **My server is listed in the server browser, but nobody can connect**
@@ -127,10 +170,15 @@ By default, Docker routes traffic through a proxy. The proxy changes the source
 
 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**
 
-# Credits
+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.
 
-Ideas borrowed from:
 
-* [Zopanix](https://github.com/zopanix/docker_factorio_server)
-* [Rfvgyhn](https://github.com/Rfvgyhn/docker-factorio)
+# Contributors
+
+* [dtandersen](https://github.com/dtandersen/docker_factorio_server) - Maintainer
+* [Zopanix](https://github.com/zopanix/docker_factorio_server) - Originator
+* [Rfvgyhn](https://github.com/Rfvgyhn/docker-factorio) - Randomly generate RCON password
+* [gnomus](https://github.com/gnomus/docker_factorio_server) - White listing
+* [jaredledvina](https://github.com/jaredledvina/docker_factorio_server) - Version update