oz0 server backup record

Record that the management database was backed up at a time with PostgreSQL's own tools (pg_dump, pgBackRest, a volume snapshot), as `server backup` records its own.

For: Operators and developers looking up a command.

Record that the management database was backed up at a time with PostgreSQL's own tools (pg_dump, pgBackRest, a volume snapshot), as server backup records its own. oz0 doctor warns when the newest recorded backup is older than the newest tenant payload key: histories written with that key could not be opened after a database loss. TIME is when the backup's snapshot began, in RFC 3339 (2026-10-08T03:00:00Z).

Usage

oz0 server backup record --taken-at TIME [flags]

Flags

FlagTypeDefaultDescription
--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) instead of a cluster's database
--notestringwhich backup, such as its name in pgBackRest: one line, kept in the audit log
--taken-atstringwhen the backup's snapshot began, in RFC 3339

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