Skip to content

orca keypair

Manage SSH key pairs.

The reference below is generated from the live CLI by mkdocs-click. It always reflects the version installed.

orca keypair

Manage SSH key pairs.

Usage:

orca keypair [OPTIONS] COMMAND [ARGS]...

Options:

Name Type Description Default
--help boolean Show this message and exit. False

Subcommands

  • create: Generate a new key pair.
  • delete: Delete a key pair.
  • generate: Generate a key pair locally and upload the public key.
  • list: List key pairs.
  • show: Show key pair details (fingerprint & public key).
  • upload: Import an existing public key.

orca keypair create

Generate a new key pair.

OpenStack generates both keys. The private key is returned ONCE and saved locally. The public key is stored server-side.

Usage:

orca keypair create [OPTIONS] NAME

Options:

Name Type Description Default
--save-to path Path to save the private key. Default: ~/.ssh/.pem None
--help boolean Show this message and exit. False

orca keypair delete

Delete a key pair.

Usage:

orca keypair delete [OPTIONS] NAME

Options:

Name Type Description Default
--yes, -y boolean Skip confirmation. False
--help boolean Show this message and exit. False

orca keypair generate

Generate a key pair locally and upload the public key.

The private key NEVER leaves your machine.

Examples: orca keypair generate my-key orca keypair generate my-key --type rsa --bits 4096

Usage:

orca keypair generate [OPTIONS] NAME

Options:

Name Type Description Default
--type choice (ed25519 | rsa | ecdsa) Key algorithm. ed25519
--bits integer Key size (RSA only, default 4096). None
--save-to path Private key path. Default: ~/.ssh/orca- None
--help boolean Show this message and exit. False

orca keypair list

List key pairs.

Usage:

orca keypair list [OPTIONS]

Options:

Name Type Description Default
--noindent boolean Disable JSON indentation. False
--max-width integer Maximum table width (0 = unlimited). None
--fit-width boolean Fit table to terminal width. False
--column, -c text Column to include (repeatable). Shows all if omitted. Sentinel.UNSET
--format, -f choice (table | json | value) Output format. table
--help boolean Show this message and exit. False

orca keypair show

Show key pair details (fingerprint & public key).

Usage:

orca keypair show [OPTIONS] NAME

Options:

Name Type Description Default
--noindent boolean Disable JSON indentation. False
--max-width integer Maximum table width (0 = unlimited). None
--fit-width boolean Fit table to terminal width. False
--column, -c text Column to include (repeatable). Shows all if omitted. Sentinel.UNSET
--format, -f choice (table | json | value) Output format. table
--help boolean Show this message and exit. False

orca keypair upload

Import an existing public key.

Examples: orca keypair upload my-key --public-key-file ~/.ssh/id_ed25519.pub orca keypair upload my-key --public-key "ssh-ed25519 AAAA..."

Usage:

orca keypair upload [OPTIONS] NAME

Options:

Name Type Description Default
--public-key-file path Path to public key file. Default: ~/.ssh/id_rsa.pub None
--public-key text Public key content as string (e.g. 'ssh-rsa AAAA...'). None
--help boolean Show this message and exit. False