Run a self-hosted server with Docker or Docker Compose

Download the Docker zip for your server, extract it and run docker compose up -d --build.

Self-Hosted Servers · Updated November 19, 2026

Click Docker under Download Server for your server in the GameVox app, extract gamevox-docker.zip, and run this inside the gamevox-docker folder:

docker compose up -d --build

The Docker download contains the x86-64 Linux binary, so it runs on x86-64 hosts only. On a Raspberry Pi or other ARM64 machine, use the Linux ARM64 download.

What is in the zip

gamevox-docker/
  gamevox-self-hosted-server    # your server's Linux binary
  Dockerfile                    # Alpine image
  entrypoint.sh                 # keeps the running binary on the data volume
  docker-compose.yml            # host networking, ports set at the top

Nothing needs editing to get started. To check it is running:

docker compose ps
docker compose logs -f gamevox
curl -k https://localhost:8088/health

Docker Desktop on Windows or macOS

The Compose file uses host networking, which works best for voice but only on native Linux Docker. On Docker Desktop, comment out network_mode: host and uncomment the ports: block:

    #network_mode: host
    ports:
      - target: *tcp_port
        published: *tcp_port
        protocol: tcp
      - target: *udp_port
        published: *udp_port
        protocol: udp

This does not map the voice TCP fallback. Add a third entry with the UDP port number and protocol: tcp if you need it. If voice fails in this mode, you may need to set PUBLIC_IP.

Run without Compose

docker build -t gamevox-self-hosted-server .
docker run -d \
  --name gamevox \
  --network host \
  -v $(pwd)/data:/app/data \
  gamevox-self-hosted-server

In PowerShell, use ${PWD} instead of $(pwd). On Docker Desktop, replace --network host with -p 8088:8088 -p 7070:7070/udp.

Change the ports

Edit the x-config block at the top of docker-compose.yml. The rest of the file picks up the values.

x-config:
  tcp_port: &tcp_port 9090
  udp_port: &udp_port 7070

With docker run, change both the variable and the mapping, for example -e TCP_PORT=9090 -p 9090:9090.

Data and updates

Everything lives in ./data on the host, mounted at /app/data. Back up that folder to back up the whole server.

The server updates itself. The running binary is kept in data/bin/, so updates survive rebuilds and reboots. To force a version, put a newer Linux binary in the folder and run docker compose up -d --build.

Common commands

docker compose up -d --build   # start, or apply changes
docker compose ps              # status and health
docker compose logs -f gamevox # follow logs
docker compose restart         # restart
docker compose down            # stop

Still need help?

Email our support team and a person will get back to you.

Email support@gamevox.com