CosmicAC Logo

Manage racks in your CosmicAC network

Register, list, and remove racks in your CosmicAC network with the CLI.

Register, list, and remove racks in your CosmicAC network.

Prerequisites

You need the following before you start:

  • A running CosmicAC deployment. See Installation.
  • Access to the deployment host, to get the ORK RPC key.
  • The CosmicAC CLI installed and configured. See Install the CLI.

Set up admin access

Admin commands authenticate with your ORK RPC key. Set this up once:

Get the ORK RPC key

On the deployment host, print the key:

task ork-key

Initialize admin access

Run cosmicac admin init, then paste the ORK RPC key at the prompt:

cosmicac admin init

CosmicAC stores the key for all later admin commands.

Register and list racks

Register a rack

Run the command without arguments for guided prompts:

cosmicac admin rack register

To register directly, pass the rack ID, type, and RPC public key. Set --location to a two-letter country code for server racks:

cosmicac admin rack register <id> <type> <rpcPublicKey> --location <CC>

Supported rack type

Set <type> to server, the only rack type currently supported.

The CLI prints Successfully registered rack: <id>.

List racks

Confirm the rack appears in the network:

cosmicac admin rack list

Each rack shows its ID, type, RPC key, location, and status.

Remove a rack

Remove one or more racks by ID:

cosmicac admin rack forget <id> [<id>...]

Run the command without arguments to select a rack interactively, or pass --all to remove every rack.

The CLI prints Successfully removed rack(s): <id>.

Next steps

On this page