Skip to content

Running Gate in Docker

Gate ships in packaged Docker images that you can use to run Gate containers or base your own images on. You can also run it in Kubernetes.

Version Tags

You can use specific version tags instead of the latest. Every commit to the main branch is built and pushed to the latest tag as well as the commit's short SHA like 6d3671c.

docker run

docker run -it --rm

This command will pull and run the latest Gate image.

  • -it - Run interactively and allocate a pseudo-TTY.
    • Alternatively using -d would run in detached mode.
  • --rm - Removes the container after it exits.

Mounting a config file

A complete config is located in repo config.yml.

docker run -it --rm \
  -v PATH-TO-CONFIG/config.yml:/config.yml \

This command will pull and run the latest Gate image.

  • -v PATH-TO-CONFIG/config.yml:/config.yml - Mounts the config file from the host system into the container.

Mounting a config file and Minekube Connect token

docker run -it --rm \
  -v PATH-TO-CONFIG/config.yml:/config.yml \
  -v PATH-TO-CONFIG/connect.json:/connect.json \

A Minekube Connect token json file can be automatically generated by running Gate with connect.enable: true in the config.



Copy the following snippet into a docker-compose.yaml file and run docker-compose up.

version: "3.9"

    container_name: gate
    restart: unless-stopped
    network_mode: host
    - PATH-TO-CONFIG/config.yml:/config.yml
    #- PATH-TO-TOKEN/connect.json:/connect.json

Running docker-compose down will stop and remove the containers.

We provide an example that configures Gate with two Minecraft servers.

git clone
cd gate/.examples/docker-compose
docker-compose up

The files of the two servers are located in the serverdata* directories. You can join at localhost:25565 and use /server to switch between the servers.


If you see the following error:

Unable to find image '' locally
docker: Error response from daemon: Head "": denied: denied.
See 'docker run --help'.


docker logout

It may be because you are logged in to the GitHub Container Registry with an outdated personal access token (PAT). Simply logout or login with a new token. It's worse to provide a bad token than not to provide a token at all. GitHub sets tokens to expire after 30 days by default.

Released under the MIT License. (web version: da9f947d)