Skip to main content
1

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

Edit the two env files

/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.
3

Deploy

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

Create tenant, organization, admin user

Interactive deploy prompts for these. In --yes mode, run them explicitly:
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
5

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.

Configuration approaches

Manual, CSV import, or git-managed — pick the one that fits your scale.

Deploy

Docker Swarm, Kubernetes, LLM providers, troubleshooting.