Skip to content

v0.22.0 - Backup import, compression, and safer GUI operations

Choose a tag to compare

@github-actions github-actions released this 13 Nov 20:45

v0.22.0 - Backup import, compression, and safer GUI operations

This release turns the backup area into a complete operational workflow: create
different backup variants from the GUI, inspect their metadata, verify them, and
import them safely as new databases.

Highlights

  • GUI backup jobs now support:
    • full native copies and restic incremental/deduplicated repositories;
    • multi-select databases in one job;
    • per-collection exclusions applied to the backup copy only;
    • gzip compression before optional age encryption;
    • local filesystem and S3/Cloudflare R2 destinations;
    • restic local and S3 repository destinations;
    • age key generation and restic password generation without exposing secrets;
    • Save & run now, live status refresh, completion notices, and the last
      destination path.
  • Every native backup now includes a human-readable backup-info.txt with
    database, job, checksum, compression, encryption, exclusions, scope, verify and
    restore instructions, and the as-is warning. It is uploaded to S3 and included
    in restic snapshots.
  • New GUI Import wizard:
    • browses backups in local folders or S3/R2 prefixes;
    • verifies checksum, decrypts age, decompresses gzip, and deep-verifies LMDB;
    • imports as a new database and never overwrites a live database.
  • Required GUI backup disclaimer before creating or running jobs.
  • GUI backup and import documentation with screenshots.
  • Auth management API and GUI: principals, one-time tokens, mTLS certificates,
    enable/disable, last-admin protection, and referenced-principal checks.
  • Native Prometheus endpoint, metrics:read scope, readiness checks, disk and
    snapshot metrics, per-collection metrics, and OpenTelemetry Collector guidance.
  • Database storage statistics and revised GUI information architecture.
  • English-only GUI and translated user-visible daemon/core errors.

Configuration

New environment variables:

  • NONODB_BACKUP_KEY_DIR — generated age/restic key directory, default
    <NONODB_DATA>/backup-keys.
  • NONODB_IMPORT_ROOTS — allowed local roots for the Import wizard, default
    <NONODB_DATA>/backups.

New defaults for new backup jobs:

  • local destination: <NONODB_DATA>/backups;
  • local restic repository: <NONODB_DATA>/restic-repo.

Existing jobs keep their configured paths.

New endpoints:

  • GET /metrics/prometheus
  • GET /readyz
  • /v1/auth, /v1/auth/principals, /v1/auth/tokens, /v1/auth/certificates
  • /v1/backups/keygen, /v1/backups/secret
  • /v1/import, /v1/import/browse, /v1/import/run,
    /v1/import/status/{id}

Upgrade notes

  • Backups now contain backup-info.txt. Native S3 jobs upload an additional
    object; automation that assumed exactly two S3 objects should account for it.
  • Import currently supports full native local/S3 backups. Selective collection
    import and restic repository import are planned for a later release.
  • Imaging and release assets remain built only by GitHub Actions.

Validation

  • cargo fmt --all --check
  • cargo clippy --workspace --all-targets -- -D warnings
  • cargo test --workspace --locked
  • python3 scripts/auth_api_test.py
  • python3 scripts/backup_api_test.py
  • python3 scripts/gui_test.py
  • python3 scripts/security_check.py — 19 passed, 4 warnings, 0 failed
  • LiveAPISec — scan 6af773f8ba45fabbd33e2fe4, 413 tests, findings
    info=6, low=9, no critical/high/medium findings.

Assets

  • Linux x86_64 .tar.gz + SHA-256
  • macOS x86_64 .tar.gz + SHA-256
  • macOS arm64 .tar.gz + SHA-256
  • Windows x86_64 .zip + SHA-256

Full changelog

v0.21.0...v0.22.0