Get latest version of OpenXcom Extended

bash get-latest.sh

Build image

bash build-latest.sh

Publish to docker hub

docker login
docker push pedroterzero/oxce:"$(cat VERSION)"
docker push pedroterzero/oxce:latest

Initial setup (needed the first time, and after update)

• Create a new empty directory and cd into it
• Create required folders

  mkdir UFO TFTD config user
  

• Copy assets into UFO/ or TFTD/, or both (see https://www.ufopaedia.org/index.php/Installing_(OpenXcom)#All_platforms)

Regular docker

• Create the container

  docker run \
   --name oxce \
   -e "MAP_UID=$(id -u)" \
   -e "MAP_GID=$(id -g)" \
   -e "PULSE_SERVER=unix:${XDG_RUNTIME_DIR}/pulse/native" \
   -e DISPLAY \
   -v "/tmp/.X11-unix:/tmp/.X11-unix:ro" \
   -v "${XDG_RUNTIME_DIR}/pulse/native:${XDG_RUNTIME_DIR}/pulse/native:ro" \
   -v "${HOME}/.config/pulse/cookie:/home/oxce/.config/pulse/cookie:ro" \
   -v "${PWD}/config:/home/oxce/.config/openxcom" \
   -v "${PWD}/UFO:/app/UFO" \
   -v "${PWD}/TFTD:/app/TFTD" \
   -v "${PWD}/user:/app/user" \
   pedroterzero/oxce:latest

Rootless docker

• Create the container

  docker run \
   --name oxce \
   -e "PULSE_SERVER=unix:${XDG_RUNTIME_DIR}/pulse/native" \
   -e DISPLAY \
   -v "/tmp/.X11-unix:/tmp/.X11-unix:ro" \
   -v "${XDG_RUNTIME_DIR}/pulse/native:${XDG_RUNTIME_DIR}/pulse/native:ro" \
   -v "${HOME}/.config/pulse/cookie:/root/.config/pulse/cookie:ro" \
   -v "${PWD}/config:/root/.config/openxcom" \
   -v "${PWD}/UFO:/app/UFO" \
   -v "${PWD}/TFTD:/app/TFTD" \
   -v "${PWD}/user:/app/user" \
   pedroterzero/oxce:rootless

All subsequent runs

docker start oxce

Updating OXCE (when a new image gets published)

docker pull pedroterzero/oxce
docker rm -f oxce

Then recreate using command from initial setup.

Updating OXCE for Rootless

docker pull pedroterzero/oxce:rootless
docker rm -f oxce

Then recreate using command from initial setup.