Use Docker to run Genisys

Tatsuyuki Ishi edited this page Mar 15, 2017 · 9 revisions

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. Running the container

To run a container with interactive command interface:
docker run -it --name genisys-production -p 19132:19132/udp quay.io/itxtech/genisys:master

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.

Taking this as an example:

        "Mounts": [
            {
                "Type": "volume",                                                      
                "Name": "6274fdc492ab3c5698d99bd3cb3b2930e2cd7eb3333d55541f0d64f21363e923",
                "Source": "/var/lib/docker/volumes/6274fdc492ab3c5698d99bd3cb3b2930e2cd7eb3333d55541f0d64f21363e923/_data",
                "Destination": "/srv/genisys",
                "Driver": "local",
                "Mode": "",
                "RW": true,
                "Propagation": ""
            }
        ],

In this case, data files are stored under /var/lib/docker/volumes/6274fdc492ab3c5698d99bd3cb3b2930e2cd7eb3333d55541f0d64f21363e923/_data.

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

Here is an asciicast (outdated):
asciicast

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.