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

# infra

> Deploy and operate 2501 on Docker Swarm or Kubernetes

`2501 infra` manages the on-premise deployment, webhooks, feature toggles, and authentication recovery. `feature` also has the alias `ft`; `status` has the alias `ps`.

For deployment fundamentals (env files, configuration, troubleshooting), see [Deploy](/0.18/deployment/overview).

## Lifecycle

```bash theme={null}
# Workspace
2501 infra init             # create /etc/2501 with env templates (run by the installer)
2501 infra config           # show the effective configuration (defaults + overlay)
2501 infra config --defaults # show only the embedded defaults

# Deploy / upgrade / inspect
2501 infra deploy           # interactive: pick a version and deploy
2501 infra deploy --yes     # CI mode: fail on missing values, no prompts
2501 infra deploy --target kubernetes --image-tag <tag>
2501 infra deploy --remove  # tear the stack down
2501 infra deploy --restart         # restart all services
2501 infra deploy --restart engine  # restart one service
2501 infra deploy --history # last few deploys

2501 infra logs                      # show engine logs
2501 infra logs command-center       # show Command Center logs
2501 infra logs engine --follow      # follow engine logs
2501 infra status           # alias: ps  - service health
```

## Initial tenant, organizations, and admin

Before the first deployment, edit `tenant.yaml`, `organization.yaml`, and `admin-user.yaml` in the installation directory. The engine creates the initial tenant, organizations, and administrator at boot. Once a tenant, organization, and user exist, this setup is skipped. Manage users and organizations in Command Center afterward.

[Users & Organizations](/0.18/deployment/users-organizations)

## Webhooks (ServiceNow)

```bash theme={null}
2501 infra webhook create \
  --name prod-incidents \
  --source-type servicenow \
  --event-type incident \
  --gateway-id gtw_xxx
2501 infra webhook delete --id whk_xxx
2501 infra webhook ls
```

After creation, the CLI prints both the URL/secret and the **ready-to-paste ServiceNow Business Rule script**. See [Webhooks](/0.18/configure/webhooks).

## Feature toggles

```bash theme={null}
2501 infra feature list                 # show all toggles + state
2501 infra feature enable <key>         # alias: e
2501 infra feature disable <key>        # alias: d
2501 infra feature enable               # interactive multi-select picker
```

List the keys available in your installation with `2501 infra feature list`. [Feature Toggles](/0.18/deployment/feature-toggles)

## Where the rest lives

* **First-time install** - your account team's installer chains `init` automatically. See [Deploy → Overview](/0.18/deployment/overview).
* **Docker Swarm setup** - [Docker Swarm](/0.18/deployment/docker-swarm).
* **Kubernetes** - [Kubernetes](/0.18/deployment/kubernetes).
* **LLM provider configuration** - [LLM Providers](/0.18/deployment/llm-providers).
* **Troubleshooting** - [Troubleshooting](/0.18/deployment/troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.