Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

backup upload-artifact

Upload an existing backup file to object storage.

Command Format:

peppykeep backup upload-artifact --input-file <FILE> [--apply] [--config-home <DIR>]

Description

  • --input-file <FILE>: Path to an existing local backup file, typically *.ppke.
  • --apply: Perform the upload; by default only checks are reported.
  • --config-home<DIR>: configuration directory.

Behaviour description

  • Without --apply, display the bucket and remote key.
  • With --apply, read [object_storage] from bak.toml and perform the upload.
  • By default, the remote key is prj_key/filename.
  • When [object_storage].prefix is nonempty, the remote key is prefix/prj_key/filename.

Dependent Configuration

  • [object_storage] in bak.toml
  • local.prj_key in prj.toml

Usage Sample

peppykeep backup upload-artifact --input-file /path/to/user/bak_u2/u2/u2-bak_2026_03_20_12_00_00.ppke --config-home /path/to/user/.peppykeep/u2-tmp
peppykeep backup upload-artifact --apply --input-file /path/to/user/bak_u2/u2/u2-bak_2026_03_20_12_00_00.ppke --config-home /path/to/user/.peppykeep/u2-tmp

Using with backup run

To generate a file locally and upload it separately:

peppykeep backup run --apply --config-home /path/to/user/.peppykeep/u2-tmp --no-upload
peppykeep backup upload-artifact --apply --input-file /path/to/user/bak_u2/u2/your-file.ppke --config-home /path/to/user/.peppykeep/u2-tmp
v26.10.2001+202610201530