hoziron-cli backup

Create, list, and restore platform state backups.

Synopsis

hoziron-cli backup <subcommand> [options]

Subcommands

Subcommand	Description
`create`	Create a platform backup
`list`	List available backups
`restore <file>`	Restore platform state from a backup file

hoziron-cli backup create

hoziron-cli backup create [--output <path>] [--agents-only] [--json]

Flags

Flag	Description	Default
`-o, --output <path>`	Output file path	`~/.hoziron/backups/<timestamp>.tar.gz`
`--agents-only`	Only back up agent state and memory (skip workflows, config, etc.)	off (`scope: "full"`)
`--json`	JSON output	—

Examples

$ hoziron-cli backup create
✓ Backup created: /root/.hoziron/backups/2026-07-08T10-15-00.tar.gz
  Size:     4213764 bytes
  Checksum: sha256:a1b2c3d4...
  Scope:    full
  ⚠ This backup contains credentials. Store securely.

# Agents/memory only, custom path
$ hoziron-cli backup create --agents-only --output /mnt/backups/agents-only.tar.gz
✓ Backup created: /mnt/backups/agents-only.tar.gz
  Size:     892011 bytes
  Checksum: sha256:e5f6a7b8...
  Scope:    agents_only
  ⚠ This backup contains credentials. Store securely.

$ hoziron-cli backup create --json
{
  "path": "/root/.hoziron/backups/2026-07-08T10-15-00.tar.gz",
  "size_bytes": 4213764,
  "checksum": "sha256:a1b2c3d4...",
  "scope": "full"
}

A backup includes provider credentials and vault contents — treat the output file the same way you'd treat a database dump with secrets in it.

hoziron-cli backup list

hoziron-cli backup list [--json]

Example

$ hoziron-cli backup list
ID                                     CREATED                 SCOPE         SIZE
b-a1b2c3d4-e5f6-7890-abcd-ef1234567890 2026-07-08T10:15:00Z    full          4.0MB
b-b2c3d4e5-f6a7-8901-bcde-f12345678901 2026-07-01T02:00:00Z    agents_only   871.1KB

$ hoziron-cli backup list --json
{
  "backups": [
    {
      "id": "b-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created_at": "2026-07-08T10:15:00Z",
      "scope": "full",
      "size_bytes": 4213764
    }
  ]
}

hoziron-cli backup restore

Restore platform state from a backup file. Destructive — replaces current platform state — so it requires --confirm, and refuses to run without it.

hoziron-cli backup restore <file> [--confirm] [--no-verify]

Flags

Flag	Description	Default
`--confirm`	Skip the confirmation gate and actually perform the restore	required to proceed
`--no-verify`	Skip checksum validation of the backup file	off (verifies)

The backup file must be accessible to the daemon (same machine or shared storage) — the CLI sends its path, not its contents, to POST /backup/restore.

Examples

# Without --confirm: prints a warning and does nothing
$ hoziron-cli backup restore /root/.hoziron/backups/2026-07-08T10-15-00.tar.gz
⚠ Restore is destructive — it replaces current platform state.
  Run with --confirm to proceed.

# With --confirm: actually restores
$ hoziron-cli backup restore /root/.hoziron/backups/2026-07-08T10-15-00.tar.gz --confirm
✓ Restored from backup b-a1b2c3d4-e5f6-7890-abcd-ef1234567890 (2026-07-08T10:15:00Z)
  Items restored: 214
  Restart the daemon to apply restored state.

hoziron-cli backup

Synopsis

Subcommands

hoziron-cli backup create

Flags

Examples

hoziron-cli backup list

Example

hoziron-cli backup restore

Flags

Examples

See Also