Skip to main content
A serverhost is a machine that runs Minecraft servers for your SimpleCloud network. Install one serverhost on each machine whose CPU and memory you want SimpleCloud to use. The serverhost runs in the background. You manage the Minecraft servers and decide which serverhosts may run them through the dashboard. Use the CLI on a serverhost when you need to start, stop, update, or troubleshoot the serverhost itself.

​
What a serverhost does

A serverhost:
  • Prepares Minecraft server files from your templates
  • Starts and stops Minecraft servers
  • Applies the software, plugins, memory, and other settings you configure
  • Sends server status, logs, and resource usage to SimpleCloud

​
Add a serverhost

In the dashboard, open Settings > Server Hosts and select Add Host. Configure the host, then run the generated setup command on the machine you want to add. The command installs SimpleCloud, connects the serverhost to your network, and starts it. For prerequisites and the complete setup process, follow the installation guide. Use Settings > Server Hosts to view and change a host’s settings. Choose which hosts may run servers when you configure a server group.

​
Check or control a serverhost

Run these commands from the SimpleCloud installation directory:

​
What happens to running Minecraft servers

When you stop or restart a serverhost, the CLI asks whether it should also stop the Minecraft servers running on that machine.
  • Choose Yes when taking the machine offline or when the Minecraft servers must stop too.
  • Choose No for short serverhost maintenance if the Minecraft servers should remain online. The serverhost reconnects to them after it starts again.
Do not shut down or reboot the machine while Minecraft servers are still running. Stop them first so they can save their data cleanly.

​
Troubleshoot a serverhost

If a serverhost is offline or a server cannot start, check that:
  • The serverhost is online.
  • It has enough free memory for the server.
  • The required Java version is installed.
  • The group is allowed to use that serverhost.
Use sc logs serverhost --lines 200 for more information. You can also review the affected Minecraft server’s logs in the dashboard.

​
Use multiple serverhosts

With multiple serverhosts, SimpleCloud can distribute servers across the machines allowed by each group. This adds capacity, but the machines do not share a filesystem.
  • Keep templates, workflows, and configurator files synchronized so a server can start correctly on any eligible host.
  • While a server is running, its files and logs exist only on the serverhost that started it.
  • A persistent server’s files stay on its assigned serverhost. Changing its serverhost does not move those files.
Follow the multi-root setup guide to add another machine and synchronize the shared files.
  • Templates explains how server files are prepared.
  • Configurators explains automatic configuration changes.
  • Workflows explains advanced preparation and cleanup steps.