CLI

The MinIO KMS minkms server process provides the following commands when invoked through a CLI or terminal:

Documentation is built into the binary

Every MinKMS release embeds this reference in the minkms binary, so the documentation always matches your installed version. Access it from any terminal:

  • minkms help — list every command and concept topic.
  • minkms <command> --help — the manual page for a command, for example minkms add-key --help.
  • minkms help <topic> — concept guides for hsm, tls, cluster, keys, enclave, iam, config, and api.

See minkms help for more information.

Cluster or host management

CommandDescription
minkms serverStart a KMS server.
minkms restartRestart cluster servers.
minkms envPrint KMS environment variables.
minkms pprofProfile KMS server performance.
minkms logsPrint KMS server logs.
minkms helpPrint help information.
minkms addAdd a node to a cluster.
minkms rmRemove a node from a cluster.
minkms lsList cluster nodes.
minkms statPrint cluster status information.
minkms editEdit the cluster configuration.
minkms backupBackup the cluster state.
minkms restoreRestore the cluster state from a backup.

Enclave management

CommandDescription
minkms add-enclaveCreate a new enclave.
minkms rm-enclaveRemove an enclave.
minkms ls-enclaveList enclaves.
minkms stat-enclavePrint enclave status information.

Encryption key management

CommandDescription
minkms add-keyCreate a new key or key version.
minkms rm-keyRemove a key or key version.
minkms ls-keyList keys or key versions.
minkms stat-keyPrint key status information.
minkms keygenGenerate a new data key.
minkms decryptDecrypt an encrypted message.

Policy management

CommandDescription
minkms add-policyCreate or overwrite a policy.
minkms rm-policyRemove a policy.
minkms ls-policyList policies.
minkms stat-policyPrint policy status information.
minkms get-policyPrint a policy.
minkms set-policyAssign a policy to an identity.

Identity management

CommandDescription
minkms identityGenerate or re-compute an identity.
minkms add-identityCreate a new identity.
minkms rm-identityRemove an identity.
minkms ls-identityList identities.
minkms get-identityPrint an identity.

On this page