Use Docker to run Genisys

You can use Docker to run Genisys, as it is easy to manage.

Here is the guide.

Install and running guide

1. Install docker

If you are installing Docker on Linux, there is a official script that 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

You should also grab a phar and store somewhere:
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: