Skip to main content
Your groups, persistent servers, and settings belong to your network, so they move with you. You only need to copy your files from the old machine to the new one. Your servers are offline during the move. If you run several serverhosts, follow Run SimpleCloud on multiple machines instead.
1

Stop all servers

Open Servers in the dashboard. Right-click each group and persistent server and hold Disable.
2

Add the new machine

Open Settings > Server Hosts, select Add host, and run the command on the new machine.
3

Wait for the network key

The new serverhost receives the key for your network’s secrets from the old one. On the new machine, run:
Continue when the log shows Shared private key synchronized from a peer serverhost.
Keep the old serverhost running until this line appears. Without the key, servers on the new machine cannot start.
4

Copy your files

Copy the templates, workflows, and options folders from the old installation to the new one. If you have persistent servers, also copy running/persistent. Do not copy secrets or serverhost.properties.
5

Assign persistent servers to the new serverhost

Open each persistent server, go to Settings > Deployment, and select the new serverhost.
6

Stop the old serverhost

On the old machine, run:
7

Start your servers again

In Servers, right-click each group and persistent server and hold Enable.
8

Remove the old serverhost

If players join with a domain, point its DNS record to the new machine’s IP address. When everything works, open Settings > Server Hosts, select Deactivate and then Delete from the old serverhost’s actions menu.