Repository navigation
v0.22.0 - Backup import, compression, and safer GUI operations
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.txtwith
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:readscope, 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/prometheusGET /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 --checkcargo clippy --workspace --all-targets -- -D warningscargo test --workspace --lockedpython3 scripts/auth_api_test.pypython3 scripts/backup_api_test.pypython3 scripts/gui_test.pypython3 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