config
Manage CLI configuration
config
Manage Arctic CLI configuration.
Synopsis
arctic config <subcommand> [flags]Subcommands
| Subcommand | Description |
|---|---|
| list | List all clusters and peers |
| view | View current configuration |
| current | Show current context |
| use-cluster | Set current cluster |
| add-peer | Add peer to a cluster |
| delete-peer | Delete peer from cluster configuration |
list
List all clusters and peers in the configuration.
Usage
arctic config listExample
arctic config listOutput
ID NAME URL LICENSE CURRENT
01HXYZABC123... Agent A http://192.168.1.10:8080 lic_... *
01HXYZDEF789... Agent B http://192.168.1.20:8080 lic_...view
View the full configuration file.
Usage
arctic config viewExample
arctic config viewOutputs the configuration in its current format.
current
Show the current context.
Usage
arctic config currentOutput
Cluster ID: 01HABC...
Name: Production
Customer ID: cust_...
Peer Count: 3
Default Peer: 01HXYZ...
Default URL: http://192.168.1.10:8080
Format: clusteruse-cluster
Set the current cluster context.
Usage
arctic config use-cluster <cluster-id-or-name>Arguments
| Argument | Description |
|---|---|
cluster-id-or-name | Cluster ID or name to set as current |
Example
arctic config use-cluster Production
arctic config use-cluster 01HABCDEF...Errors
| Error | Description |
|---|---|
cluster not found | Cluster not in config |
add-peer
Add a peer configuration to a cluster.
Usage
arctic config add-peer --peer-id <id> --peer-url <url> [flags]Required Flags
| Flag | Description |
|---|---|
--peer-id | Peer ID |
--peer-url | Agent URL |
Optional Flags
| Flag | Description |
|---|---|
--cluster | Cluster ID or name (defaults to current cluster) |
--name | Human-readable name for the peer |
Example
arctic config add-peer \
--peer-id 01HXYZ... \
--peer-url http://192.168.1.30:8080 \
--name "Agent C" \
--cluster Productiondelete-peer
Delete a peer from the cluster configuration.
Usage
arctic config delete-peer <peer-id-or-name> [flags]Arguments
| Argument | Description |
|---|---|
peer-id-or-name | Peer ID or name to delete |
Optional Flags
| Flag | Description |
|---|---|
--cluster | Cluster ID or name (defaults to current cluster) |
Example
arctic config delete-peer Agent-C
arctic config delete-peer Agent-C --cluster ProductionRequires confirmation unless --yes is specified.
See Also
- CLI Configuration - Config file format
- bootstrap - Initial setup