Skip to main content
The SimpleCloud CLI lets you set up a serverhost and manage your network from the terminal. Use it to control the SimpleCloud installation on the current machine or manage groups and Minecraft servers across your network.
Run sc --help to see all commands, or sc <command> --help for help with a specific command.

Install the CLI

Run the installer on the machine that will host SimpleCloud:
Then check that the CLI is available:
For the complete first-time setup, follow Installation.

Set up your serverhost

Start the setup wizard:
The wizard signs you in, connects the machine to your network, and installs the serverhost. When it finishes, you can manage SimpleCloud from the CLI or dashboard.

Manage SimpleCloud on this machine

Use these commands to operate the local installation:
Local commands such as sc start manage SimpleCloud on the current machine. Commands under sc server manage Minecraft servers in your network.

Manage groups and servers

Create a server group with the interactive wizard:
You can then start a server and view the running servers:
Use these commands for common server tasks:
See Server groups and Servers for the complete workflows.

Update SimpleCloud

Upgrade the CLI and installed SimpleCloud components with one command:
If an installed component needs to be downloaded again, run:

Sign in

Run sc login when you need to sign in again. Use sc whoami to check the current account and sc logout to sign out.

Switch between networks

The CLI saves each network as a context and sends network commands to the active one. Setup creates your first context automatically.
Run sc context add to connect the CLI to another network.

Add another serverhost

On the new machine, install the CLI and run:
Follow Multi-root setup for the complete process.

Discover more commands

The CLI also supports templates, persistent servers, multiple contexts, and advanced installation options. These workflows have their own guides, while the CLI’s built-in help always shows the current command syntax:
Learn more in Templates and Persistent servers.