> ## Documentation Index
> Fetch the complete documentation index at: https://simplecloud.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Set up and manage SimpleCloud from your terminal

## Install the CLI

Run the installer on the machine that will host SimpleCloud:

```bash theme={null}
curl -fsSL https://get.simplecloud.app | bash
```

Then check that the CLI is available:

```bash theme={null}
sc --version
```

To set up the first serverhost from the dashboard, follow [Installation](/docs/en/manual/setup/installation). To complete the setup from the CLI, continue below.

## Set up your serverhost

Start the setup wizard:

```bash theme={null}
sc setup
```

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:

| Task | Command |
| - | - |
| Start SimpleCloud | `sc start` |
| Stop SimpleCloud | `sc stop` |
| Restart SimpleCloud | `sc restart` |
| Check its status | `sc status` |
| View serverhost logs | `sc logs serverhost` |
| Open the serverhost console | `sc attach serverhost` |

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:

```bash theme={null}
sc group create
```

You can then start a server and view the running servers:

```bash theme={null}
sc group start lobby
sc server list
```

Use these commands for common server tasks:

```bash theme={null}
sc server info lobby 1
sc server logs lobby 1 --follow
sc server stop lobby 1
```

See [Server groups](/docs/en/manual/setup/server-groups) and [Servers](/docs/en/manual/setup/servers) for the complete workflows.

## Update SimpleCloud

Upgrade the CLI and installed SimpleCloud components with one command:

```bash theme={null}
sc upgrade
```

If an installed component needs to be downloaded again, run:

```bash theme={null}
sc repair
```

## 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.

```bash theme={null}
sc context list
sc context use <name>
```

Run `sc context add` to connect the CLI to another network.

## Add another serverhost

On the new machine, install the CLI and run:

```bash theme={null}
sc serverhost add
```

Follow [Multi-root setup](/docs/en/manual/setup/multi-root) 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:

```bash theme={null}
sc --help
sc group --help
sc server --help
sc persistent-server --help
```

Learn more in [Templates](/docs/en/manual/setup/templates) and [Persistent servers](/docs/en/manual/setup/persistent-servers).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.