bootstrap
Initialize an Arctic agent with a license
bootstrap
Initialize an Arctic agent with a license file.
Synopsis
arctic bootstrap --url <agent-url> --license-file <path> [flags]Description
The bootstrap command initializes an Arctic agent with a license. This process:
- Uploads the license to the agent
- Generates a unique peer identity (Ed25519 key pair)
- Creates OAuth2 credentials for API access
- Saves the configuration to your CLI config file
Required Flags
| Flag | Description |
|---|---|
--url | Agent URL (e.g., http://192.168.1.10:8080) |
--license-file | Path to the license JSON file |
Optional Flags
| Flag | Default | Description |
|---|---|---|
--name | Human-readable name for this peer |
Output
On success, displays:
Peer ID: 01HXYZ...
Cluster ID: 01HABC...
Client ID: cl_01HXYZ...
License ID: lic_abc123...
Expires: 2025-12-31 23:59:59 UTC
Max Nodes: 10
Max Services: 100
Configuration saved to ~/.config/arctic/config.yaml
Set as current cluster: 01HABC...Examples
Basic Bootstrap
arctic bootstrap \
--url http://192.168.1.10:8080 \
--license-file license.jsonWith Name
arctic bootstrap \
--url http://192.168.1.10:8080 \
--license-file license.json \
--name "Production Server 1"Errors
| Error | Description |
|---|---|
--license-file is required | Missing license file flag |
--url is required for bootstrap | Missing agent URL |
failed to read license file | License file not found or invalid JSON |
license has expired | License expiration date has passed |
agent is already bootstrapped | Agent was previously initialized |
Notes
- An agent can only be bootstrapped once. To re-bootstrap, you must reset the agent's database.
- Credentials are saved automatically to your CLI config file.