Skip to content

zerobyte

v0.37.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 14d Backup & Recovery
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Affected surfaces

auth

Summary

AI summary

Recovery key may need re‑download due to possible truncation on slow connections.

Changes in this release

Security Medium

SFTP private keys stored in secure temporary runtime locations, avoiding permission problems on bind-mounted storage.

SFTP private keys stored in secure temporary runtime locations, avoiding permission problems on bind-mounted storage.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Feature Medium

SMB volumes can choose to map all files to container user/group or preserve SMB server ownership view.

SMB volumes can choose to map all files to container user/group or preserve SMB server ownership view.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Feature Medium

Backup execution validates volume readiness more consistently and surfaces clearer volume-related failures before Restic runs.

Backup execution validates volume readiness more consistently and surfaces clearer volume-related failures before Restic runs.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Performance Medium

Repository locks persisted in database, reducing false lock failures from background checks, restarts, or isolated states.

Repository locks persisted in database, reducing false lock failures from background checks, restarts, or isolated states.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Bugfix High

Recovery key download may truncate password; admins should redownload the 64‑character key.

Recovery key download may truncate password; admins should redownload the 64‑character key.

Source: granite4.1:30b@2026-05-20-audit

Confidence: low

Bugfix Medium

Recovery key download clarifies when local credential password is required, instead of ambiguous password error.

Recovery key download clarifies when local credential password is required, instead of ambiguous password error.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Bugfix Medium

Recovery key downloads keep browser download URL alive briefly before revoking it, reducing truncated downloads chance.

Recovery key downloads keep browser download URL alive briefly before revoking it, reducing truncated downloads chance.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: high

Bugfix Medium

Backup retry settings preserved when enabling or disabling a backup schedule.

Backup retry settings preserved when enabling or disabling a backup schedule.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: low

Bugfix Medium

Encrypted values created with different APP_SECRET rejected earlier, preventing later obscure failures.

Encrypted values created with different APP_SECRET rejected earlier, preventing later obscure failures.

Source: granite4.1:8b-q6_K@2026-05-20

Confidence: low

Full changelog

⚠️ Action Required
Recovery key re-download: Admins and owners who previously downloaded the recovery key may be asked to download it again. The code was previously too eagerly closing the stream when downloading the password file which in combination with a slow connection to the server and some specific browsers would result in a password missing one or two characters at the end. The problem is very unlikely to happen but download the file again and make sure your existing saved one matches the new 64 character one.

New features

  • SMB volumes can choose whether to map all files to the container user/group or preserve the ownership view reported by the SMB server. Existing SMB volumes keep the old mapping behavior automatically

Improvements

  • Repository locks are now persisted in the database, reducing false “repository is already locked” failures caused by background checks, restarts, or isolated lock state.
  • Better volume handling during backups: Backup execution now validates volume readiness more consistently and can surface clearer volume-related failures before running Restic.
  • SFTP private keys are stored in secure temporary runtime locations, avoiding permission problems on bind-mounted storage such as Synology DSM.
  • HTTP request/access logs now use debug logging, so LOG_LEVEL=warn no longer floods container logs during normal use.

Bug fixes

  • Backup retry settings are preserved when enabling or disabling a backup schedule.
  • Recovery key download now clearly explains when a local credential password is required instead of failing with an ambiguous password error.
  • Recovery key downloads now keep the browser download URL alive briefly before revoking it, reducing the chance of truncated downloads.
  • Encrypted values created with a different APP_SECRET are rejected earlier instead of failing later in less obvious ways.

Breaking Changes

  • Recovery key download may require admins/owners to obtain a new 64‑character key due to possible truncation on slow connections.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track zerobyte

Get notified when new releases ship.

Sign up free

About zerobyte

Backup automation for self-hosters. Built on top of restic

All releases →

Beta — feedback welcome: [email protected]