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

# Setup

> Configure your tenant before first use.

Before using crcli, you need to tell it which Cloud Red tenant to connect to.

## Configure Your Tenant

```shell theme={null}
crcli setup <your-tenant-name>
```

Your tenant name is the subdomain of your Cloud Red portal URL.

<Info>
  If your portal is at `acme.portal.cloud.red`, your tenant name is `acme`.
</Info>

This stores your tenant config at `~/.config/crcli/portal.json`. You only need to run this once — or whenever you switch tenants.

## Verify

```shell theme={null}
crcli whoami
```

After authenticating, this prints your user details and confirms which tenant you're connected to.

## Next Step

Once your tenant is configured, [authenticate](/crcli/getting-started/authentication) to get started.