oz0 server secrets-key create

Write a new secrets key: the private key that tenant secrets are sealed to with HPKE.

For: Operators and developers looking up a command.

Write a new secrets key: the private key that tenant secrets are sealed to with HPKE. Give the file to every server that runs the edge role with --secrets-key-file, and to no server that runs only management. The first edge that starts with it publishes its public half; management then seals every new secret to it, and the edges seal the existing ones to it, so that management can store tenant secrets but not open them.

Keep a copy with the master key: losing it loses every secret sealed to it. With --command the new key is wrapped by that key command before it is written, so it is never on disk in the clear.

Usage

oz0 server secrets-key create [flags]

Flags

FlagTypeDefaultDescription
--commandcommanda key command that wraps the new key before it is written
--outstringthe file to write; it must not exist

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