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:
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:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--save-to |
path | Path to save the private key. Default: ~/.ssh/ |
None |
--help |
boolean | Show this message and exit. | False |
orca keypair delete¶
Delete a key pair.
Usage:
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:
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:
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:
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:
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 |