Set Up Your First Server (/first-run)
v1.0
·
Updated 5 days ago
Set Up Your First Server: /first-run
When your inventory is still empty, start with /first-run. The command invokes the interactive fleet-intake agent, which guides you step by step through adding your first server.
What the intake agent asks
| Field | Description |
|---|---|
| Server name | unique name, only a–z, 0–9, _, - (e.g. homeserver) |
| Host | hostname, IP address or domain |
| SSH port | 1–65535 (default 22) |
| SSH user | the login user on the server |
| Description | optional free text |
What happens next
- The agent creates the server profile at
context/servers/<name>.md. - It guides you through SSH key deployment (see the next page).
- It tests the connection and detects operating system, architecture and Docker.
- You set the scopes — which operations should be allowed on this server.
- The server is marked active and the inventory is updated.
You can add more servers any time later with /add-server.