oz0 server provisioner issue

Issue a key and a provisioner certificate valid for 90 days, and a CLI context, and add the provisioner if the cluster has none of that name.

For: Operators and developers looking up a command.

Issue a key and a provisioner certificate valid for 90 days, and a CLI context, and add the provisioner if the cluster has none of that name. --provider names each identity provider it may act for (repeat it), replacing the ones it had. It runs on a server's machine: it reads the database and the master key. The provisioner renews its certificate with oz0 operator renew in its context.

Usage

oz0 server provisioner issue NAME --provider ID [flags]

Flags

FlagTypeDefaultDescription
--advertisestring127.0.0.1server address for a new CLI context
--ca-signer-commandcommanda command that signs with the cluster CA's key outside the server, such as in an HSM or a KMS: "COMMAND public-key" prints the key as PEM, "COMMAND sign sha256" signs the digest on stdin
--data-dirstring~/.local/share/orchestrator-zeroserver data directory
--db-filefilea file (- for stdin) holding the PostgreSQL URL of the management database, such as postgres://oz0:PASSWORD@db:5432/oz0 (or set OZ0_DB); the URL can carry a password, so it never goes on the command line
--devboola dev server's data directory (--data-dir): its database and master key
--dirstring<config dir>/orchestrator-zero/provisioner-<name>where to write the credentials
--master-key-commandcommanda command that unwraps the master key from --master-key-file when the file holds it wrapped, such as with an HSM or a KMS: "COMMAND unwrap" prints the key from the wrapped document on stdin, "COMMAND wrap" wraps one, "COMMAND describe" says what holds the wrapping key (see the docs on key commands) (or set OZ0_MASTER_KEY_COMMAND)
--master-key-filestring<data-dir>/master.keymaster key file
--providerstringArrayan identity provider it may act for (repeat it)

Inherited flags

FlagTypeDefaultDescription
--contextstring$OZ0_CONTEXT or <config dir>/orchestrator-zero/context.jsonCLI context file written by server init
--log-levelstringinfolog level: debug, info, warn or error

See all oz0 commands and the global flags.

On this page
Copyright © 2026