Move a self-hosted server to another machine
Stop the server, copy its whole data folder to the new machine, and start your server's own binary there. Run only one copy at a time.
Stop the server, copy its whole data folder to the new machine, and start your server's binary there with that folder as its data directory. Channels, messages, files and settings all come along.
Use your own server's binary. The databases are encrypted with a key tied to your server, so a binary for a different server cannot open them. You can switch operating system: every download for your server (Windows, Linux, Linux ARM64, Docker) opens the same data folder.
Find the data folder
| Setup | Default data folder |
|---|---|
| Windows | %ProgramData%\GameVox-Server\ |
| Linux service | /opt/gamevox/data/ |
| Linux, run directly | data next to the binary |
| Docker Compose | ./data next to docker-compose.yml |
A second server on one machine uses a folder ending in -2. On a Linux service install, sudo gamevox data-dir prints the folder. If you set FILES_DIR or BACKUPS_DIR, copy those folders too.
Move it
- Stop the server on the old machine.
- Copy the data folder, plus any
FILES_DIRandBACKUPS_DIRfolders, to the new machine. - Download your server's binary for the new machine from Server Settings > Server > Download Server, and start it with the copied folder:
- Windows. Run the
.exe, set Data Directory to the copied folder, and click Save & Start. Or, from an Administrator PowerShell, run.\gamevox-self-hosted-server.exe --install-service --data-dir=D:\path\to\data. - Linux. Run
sudo ./gamevox-self-hosted-server --installand enter the copied folder at the Data directory prompt. - Docker. Extract your server's Docker zip, put the copied folder at
gamevox-docker/data, and rundocker compose up -d --build.
- Windows. Run the
- Open the ports on the new machine and router. See ports and port forwarding.
- Once members can connect, delete the old copy or make sure it can never start.
The server tells the GameVox cloud its new address when it connects, so members do not need a new invite.
If you copied files into a Linux service install after installing, give them to the service user, or the server reports a read-only database:
sudo chown -R gamevox:gamevox /opt/gamevox/data Run only one copy
If two copies connect at once, GameVox disconnects one with "Another instance of the self-hosted server connected using the same server token".