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

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.

<Tip>
  Run `sc --help` to see all commands, or `sc <command> --help` for help with a specific command.
</Tip>

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

For the complete first-time setup, follow [Installation](/docs/en/manual/setup/installation).

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

<Note>
  Local commands such as `sc start` manage SimpleCloud on the current machine. Commands under `sc server` manage Minecraft servers in your network.
</Note>

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