Documentation CLI 0.1.1 · development llms.txt

coldctl archive import

Recover a completed archive into local state.

ImplementedLocal state write

Syntax

USAGE

coldctl archive import [OPTIONS] --accept-untrusted-manifest <DIRECTORY>

Arguments & options

Argument	Description
`<DIRECTORY>`	Completed archive directory named with its original job UUID.

Option	Description / default
`--accept-untrusted-manifest`	Acknowledge that supplied files and manifest do not prove authenticity
`--data-dir <PATH>`	Override the OS application data directory
`--output <OUTPUT>`	[default: table] [possible values: table, json]
`-h, --help`	Print help

Examples

Replace configuration names, paths and JOB_ID with values from your installation. Examples are not executed by this page.

CLI

coldctl --data-dir ./recovered-state archive import ./archives/JOB_ID --accept-untrusted-manifest --output json

Operational notes

Initialize the target state first. Explicitly acknowledges that supplied archive files do not prove authenticity. Verifies files before atomically importing completed-job metadata; duplicate IDs are refused. Does not recreate sources/policies or enable additional export rows. Partial exports still need their original journal and referenced files.

Output, placeholders & global flags

View exact CLI help

HELP OUTPUT

Verify and import a completed archive; never overwrites an existing job ID

Usage: coldctl archive import [OPTIONS] --accept-untrusted-manifest <DIRECTORY>

Arguments:
  <DIRECTORY>  

Options:
      --accept-untrusted-manifest  Acknowledge that supplied files and manifest do not prove authenticity
      --data-dir <PATH>            Override the OS application data directory
      --output <OUTPUT>            [default: table] [possible values: table, json]
  -h, --help                       Print help