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

# Quickstart

> Install the CLI, deploy 2501, and run your first agent

<Steps>
  <Step title="Install the 2501 CLI">
    Your 2501 account team provides the installer. It places a checksum-verified static binary, sets up the sudo wrapper, and runs a non-interactive `init` so you finish with a ready-to-edit workspace.

    No Docker, AWS CLI, or registry login needed on the machine.
  </Step>

  <Step title="Edit the two env files">
    ```bash theme={null}
    /etc/2501/env.engine
    /etc/2501/env.command-center
    ```

    Set your LLM provider API keys and the external `DATABASE_URL` in `env.engine`. The CLI generates and defaults everything else.
  </Step>

  <Step title="Deploy">
    ```bash theme={null}
    2501 infra deploy
    ```

    The CLI lists published releases newest-first, self-updates to match the version you pick, syncs env files, runs migrations, and brings up the stack.

    For Kubernetes, add `--target kubernetes` — it generates a manifest tree you apply with `kubectl`.
  </Step>

  <Step title="Create tenant, organization, admin user">
    Interactive deploy prompts for these. In `--yes` mode, run them explicitly:

    ```bash theme={null}
    2501 infra tenant create --name "My Company"
    2501 infra org create --name "Engineering" --tenant-id ten_xxx
    2501 infra user create --email you@company.com --role ADMIN \
      --tenant-id ten_xxx --org-id org_xxx
    ```
  </Step>

  <Step title="Open Command Center">
    Sign in at your Command Center URL with the admin account. From there, register your first host, attach an agent, and send a task.
  </Step>
</Steps>

## What to read next

<CardGroup cols={2}>
  <Card title="Configuration approaches" icon="gears" href="/0.8/understand/configuration">
    Manual, CSV import, or git-managed — pick the one that fits your scale.
  </Card>

  <Card title="Deploy" icon="cloud-arrow-up" href="/0.8/deployment/overview">
    Docker Swarm, Kubernetes, LLM providers, troubleshooting.
  </Card>
</CardGroup>