Use Docker to run Genisys

Docker is an easy way to manage server by using containers.

Install and running guide

1. Install Docker

If you are installing Docker on Linux, there is a official script which does all work for you.

Run this command:
curl -sSL https://get.docker.com/ | sh

Don't forget to enable the service.
If your distro is using systemd:
sudo systemctl enable docker
And have a reboot.

If you are on other operating system, consider looking at official documentation or use an alternative way to install.

2. Downloading Genisys Docker image and phar

To pull the docker image:
docker pull itxtech/docker-env-genisys

To download the phar:
curl <URL> -o genisys.phar

The URL is something like https://gitlab.com/itxtech/genisys/builds/<build ID>/artifacts/file/Genisys_<version>.phar

You can get it from GitLab CI.

3. Running the container

To run a container with interactive command interface:
docker run -it --name genisys-production -p 19132:19132/udp -v <absolute path to genisys.phar>:/srv/genisys/genisys.phar itxtech/docker-env-genisys

To attach to a stopped container:
docker start -ai genisys-production

To remove a stopped container with its data:
docker rm genisys-production

To get the path of data:
docker inspect genisys-production
Then find for "Mounts": the "Source" property is the path of the server data.

You are free to replace your favorite container name instead of "genisys-production".

Here is an asciicast: