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.
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