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.

Self-Hosted Servers · Updated November 19, 2026

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

SetupDefault data folder
Windows%ProgramData%\GameVox-Server\
Linux service/opt/gamevox/data/
Linux, run directlydata 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

  1. Stop the server on the old machine.
  2. Copy the data folder, plus any FILES_DIR and BACKUPS_DIR folders, to the new machine.
  3. 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 --install and 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 run docker compose up -d --build.
  4. Open the ports on the new machine and router. See ports and port forwarding.
  5. 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".

Still need help?

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

Email support@gamevox.com