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

# Authentication

> Log in to your BRICKS workspace

CTOR connects to your BRICKS workspace for project management, deployment, and pulling app files. You can log in with a one-time passcode or a workspace token.

## Log in with a passcode

<Steps>
  <Step title="Open the control panel">
    Click the link on the login screen to open the [BRICKS Controller](/controller) token management page in your browser.
  </Step>

  <Step title="Generate a passcode">
    In BRICKS Controller, open **Manage API Tokens** and generate a one-time passcode.
  </Step>

  <Step title="Enter the passcode">
    Paste the passcode into the login screen and click **Login**.
  </Step>
</Steps>

## Log in with a token

If you have a workspace token, you can use it directly:

1. On the login screen, expand **Login with Token**
2. Paste your workspace token
3. Click **Login**

## Multi-profile support

You can configure multiple workspace profiles and switch between them. Each profile stores its own authentication token and workspace connection.

### Add a profile

1. Open **Settings** > **Account**
2. Click **Add profile**
3. Log in with the new workspace credentials

### Switch profiles

1. Open **Settings** > **Account**
2. Click **Switch** next to the profile you want to use

You can also switch from the [main chat](/ctor/guide/main-chat#switch-workspace-profile) input bar — click the workspace pill next to the sandbox-mode selector and pick a profile from the dropdown.

Switching profiles applies globally — all open projects use the active profile.

### Remove a profile

In **Settings** > **Account**, click **Remove** next to any profile that is not currently active.

<Info>
  Credentials are stored locally at `~/.bricks-cli/config.json`.
</Info>

## Connection status

The settings panel shows a connection indicator next to each profile:

* **Green dot** — connected and authenticated
* **Red dot** — connection failed or token expired

If your connection fails, try logging out and logging back in to refresh your token.

## Next steps

<Card title="Set up a project" icon="folder-open" href="/ctor/guide/project-setup">
  Open or create a BRICKS project.
</Card>