Proxmox Backup Server 4.1.1 → 4.1.12
10 releases · 1 breaking change · 0 security fixes · 0 advisories fixed
0security1breaking0deprecated20feature21fix
Breaking changes
- breaking fix client metadata-mode incremental backups breaking with strict payload-offset rejections introduced in pxar 1.0.1: hold-back chunks could survive across cache-range discontinuities and produce non-monotonic PXAR_PAYLOAD_REF offsets on disk. Inject any held chunk explicitly when a discontinuity… in 4.1.12
Security changes
None in the release notes.
Every release in between
4.1.12 Apr 28, 2026
otherpull sync: surface CRC errors on the source manifest as actual errors instead of silently treating them as a vanished snapshot.
otherpull sync: bail with a snapshot-prefixed 'archive missing on source' error when fetching a referenced archive returns no data, instead of silently continuing and failing later in the index parser with a confusing message.
otherpull sync: handle vanished snapshots uniformly between local and remote sources, so a concurrent prune during a local-source sync no longer aborts the whole group with 'No such file or directory' but skips the affected snapshot like the remote path already did.
otherpull sync: clean up leftover .tmp files and the otherwise empty freshly-created snapshot directory when a source snapshot vanishes mid-sync or a referenced archive is missing, and drop the misleading 'sync done' log line for snapshots that never actually synced.
otherpull sync: emit an explicit 'skipped' log line for snapshots that fail the verified-only or encrypted-only post-filter check, so the encrypted-only rejection case is no longer silent.
breakingfix client metadata-mode incremental backups breaking with strict payload-offset rejections introduced in pxar 1.0.1: hold-back chunks could survive across cache-range discontinuities and produce non-monotonic PXAR_PAYLOAD_REF offsets on disk. Inject any held chunk explicitly when a discontinuity…
otherclient: show the full error context on upload failures in single-line form, restoring information that was lost when the metadata and payload upload streams were split.
otherui: sync/verify view: show the correct duration of finished tasks in the task log window, instead of computing the duration against the current time.
4.1.11 Apr 25, 2026
featurepull sync: avoid double-decoding blob files on the decrypt-on-pull path, which broke any pull sync job that should have decrypted snapshot manifests, catalogs or other blob files using a configured decryption key. The decrypt-on-pull feature was introduced in 4.1.9.
featurepull sync: also fetch the client log for local sync jobs, where the implementation had been a no-op stub since the trait was first introduced. Skip silently if the source snapshot has no client log, matching the existing behavior of remote sync jobs.
otherpull sync: decrypt the client log on the fly when a matching decryption key is configured, mirroring the existing decrypt-on-pull behavior for the rest of a snapshot's data.
featureui: encryption keys: always enable the tape key restore button and rename it to 'Restore Tape Key'. Restoring loads a new key, so an existing tape key does not need to be selected first; this matches the existing behavior in the tape backup view.
4.1.10 Apr 24, 2026
featureapi: add new '/nodes/localhost/identity' endpoint that returns a stable, unique instance ID derived from /etc/machine-id, for uniquely identifying a PBS node. Primarily useful for matching PBS storages in a PVE cluster to PBS remotes in PDM.
featureclient, manager: add 'server-identity' CLI subcommand to query the instance ID from the backup client and admin tools.
featurecli: migrate the 'move-group' and 'move-namespace' commands introduced in 4.1.9 from the manager to the backup client, exposed as 'group move' and 'namespace move' respectively, where they fit better alongside the other group and namespace subcommands. This also implicitly fixes any permission…
otherapi: namespace move: create the target namespace automatically if it does not exist yet (its parent namespace must still exist), matching what a plain file 'mv' does.
fixfix: sync: pull: distinguish signed-only from fully encrypted snapshots when deciding whether to decrypt on pull. The mere presence of a key fingerprint on the source manifest was previously taken as proof of encryption, which could cause pull sync jobs with a matching decryption key to fail on…
otherpartially fix #6372: acme: also pick a shorter renewal lead of half the certificate lifetime for short-lived certificates (under ten days total), following the Let's Encrypt integration guide. The previous 1/3 fraction still applies for longer-lived certificates.
otherui: datastore create: drop the now outdated 'technology preview' label for S3-backed datastores.
otherui: tape: tune vertical alignment of the tape icon in tree views so it sits better next to the surrounding text.
otherdocs: describe the S3 request counters, how they can trigger notifications, and the periodic threshold reset schedule.
otherdocs: list previously missing entries under the configuration subtree with a short description of each.
4.1.9 Apr 23, 2026
others3: graduate the S3 datastore backend from technology preview to a fully supported feature; drop the corresponding preview note from the docs.
fixfix #7251: sync jobs: support server-side encryption of snapshots using encryption keys stored on the datastore server. Push sync jobs can encrypt previously unencrypted source snapshots on the fly while uploading to the remote; pull sync jobs can decrypt snapshots with a matching key and store…
featureconfig: add 'encryption-keys' as ACL subpath under 'system' for more granular access control over individual encryption keys.
featureui: expose encryption key management via a new menu (list, create, archive/unarchive and delete keys) and allow assigning an active encryption key and associated decryption keys in the sync job editors.
fixfix: sync: pull: also upload the client log to s3-backed target datastores in the "no data changes" fast-path; this was previously only done on full resync.
otherdocs: add chapter on server-side encryption for sync jobs, covering key management, associated keys and requirements for removing keys.
otherui: sync job edit: show a direction-specific hint in the encryption panel, since pull sync jobs only use configured keys to decrypt and never encrypt, which is easy to miss without an explicit note.
otherapi/ui: sync job: reject setting the active encryption key on pull sync jobs (including switching a push job with an active key over to pull without clearing it first), since the active key is only consumed by the push side and would otherwise be silently ignored.
featureadd move operations for backup groups and entire namespace subtrees within the same datastore, covering both filesystem and S3 backends and preserving group notes. Snapshots can be merged into an existing target group when ownership matches and source snapshots are strictly newer. Exposed via new…
featuredatastore: add a per-datastore move journal consumed by the mark phase of garbage collection, closing a race where a concurrent move-group or move-namespace could cause the mark phase to miss a relocated index, which would let the sweep phase remove its still-referenced chunks.
otherdocs: add section on moving namespaces and groups.
otherui: show empty backup groups. Previously, removing the last snapshot of a group also removed the group itself, discarding group-level metadata like notes; it also prevented cleaning up groups left behind by a partially failed move on an S3-backed datastore without going through the API.
otherpartially fix #6372: acme: scale certificate renewal check cadence with certificate lifetime. Start renewing once 2/3 of the total lifetime have passed instead of the hard-coded 30 days, with a minimum of 3 days remaining to still cope with transient failures. This lets short-lived (e.g. 7-day…
otherdocs: sync: document the new 'worker-threads' option for parallel sync jobs.
otherdocs: storage: document the 'gc-on-unmount' flag for removable datastores.
4.1.8 Apr 22, 2026
fixfix #4182: sync jobs: allow pulling or pushing backup groups in parallel, configurable via the new 'worker-threads' sync job property (1 to 32, defaults to 1 for sequential). Significantly improves throughput on high-latency connections where the single HTTP/2 connection to the source was limited…
othersync jobs: in parallel mode prefix log messages by group and buffer them briefly, so lines from concurrent groups stay readable and do not interleave excessively.
featureui: sync job edit: expose the new parallel group worker count setting.
featureapi: datastore: add 'gc-on-unmount' option for removable datastores, which runs garbage collection automatically before unmounting. This gives setups relying on auto-unmount a natural point to run GC. The unmount waits for the GC run, or an already running one, to complete. Rejected on…
featureui: datastore options: expose the new 'gc-on-unmount' toggle for removable datastores.
featuretools: move ParallelHandler to the new proxmox-parallel-handler crate in the proxmox-rs workspace, for reuse across Proxmox products.
otherbump proxmox-shared-memory to 1.0.2, which immediately flushes the contents of newly created mmap files, avoiding a possible race between a file being initialized and another consumer opening it while checking its header.
featureclient: add --server, --port, --datastore, --auth-id and --ns as per-field alternatives to the compound --repository URL across all client tools (proxmox-backup-client, proxmox-file-restore, proxmox-backup-debug). Each has a matching PBS_SERVER, PBS_PORT, PBS_DATASTORE, PBS_AUTH_ID environment…
fixfix #5340: client: add PBS_NAMESPACE environment variable as a per-tool fallback for --ns, consistent with the other PBS_* atom environment variables.
otherdocs: document the new per-field client repository options, their mutual exclusion with --repository, and the corresponding PBS_* environment variables.
fixfix #7337: ui: preserve the target deep link when redirecting through an OpenID login round-trip. The hash was previously dropped, sending users to the dashboard instead of their originally requested view after logging in.
fixfix #7400: handle corrupted or missing job statefiles gracefully. The API no longer errors out when the statefile cannot be parsed (a default schedule status is returned instead), and the scheduler loops actively overwrite corrupted statefiles on the next run so affected jobs resume normally.
fixpbs-key-config: fsync() newly stored encryption keys to match the replace path, so a crash between key creation and the next filesystem flush cannot leave the key partially written on disk.
4.1.7 Apr 15, 2026
otherbump pxar dependency, adding a consistency check for payload reference offsets in split archives.
fixfix #7382: correctly anchor nested paths for include/exclude patterns. Anchored patterns in subdirectories were not matched because the leading slash was not prepended to the match path.
fixfix #7329: api: avoid overwriting existing IPv6 config method. Setting IPv4 configuration could silently reset the IPv6 method to manual, causing the inet6 stanza to be dropped from the interfaces file.
othersystem report: adapt to the ZFS arcstat CLI tool getting renamed to zarcstat.
fixfix #7412: ui: dashboard: persist datastore usage column configuration across page reloads and navigations.
otherui: task descriptions: use title case also for 'Format Media' task.
others3: bump proxmox-s3-client to 1.4.0, fixing the Content-Type for object upload and copy requests to application/octet-stream instead of the non-standard binary/octet.
fixfix #6716: pass node http proxy config to s3 backend, so that S3 operations respect the configured HTTP proxy.
features3: add request statistics with configurable notification thresholds and scheduled counter resets, allowing to monitor and alert on S3 backend traffic.
otherpartially fix #6563: ui: expose s3 rrd charts in datastore summary.
otherapi: metrics: support sub-path metric object IDs, so that S3 sub-metrics inherit their parent datastore's permissions.
otherapi: datastore: include backend type in listing response, allowing the UI to distinguish backends without loading the full config.
otherui: s3: hide S3-only options for non-S3 datastores.
otherui: datastore summary improvements:
othergive notes panel its own full row.
otheruse backend-type from datastore list API for immediate S3 detection.
4.1.6 Mar 19, 2026
fixfix #3723: api: remote: optionally use node proxy config for http client
fixfix #7078: ui: S3: expose "DeleteObjects via DeleteObject" provider quirk
otherapi: status/datastore: expose backend type in datastore status/list
otherui: Set datastore usage related titles based on backend
otherbump proxmox-fuse to 3
fixfix #7017: cache token.shadow verification results
4.1.5 Mar 10, 2026
fixapi: backup: don't verify total file size for incremental backups to fix a critical regression with the previous version bump and incremental qemu backups. As there, the submitted value is currently the upload size instead of the total size.
otherapi: backup: disallow incremental backups with different index length again. Currently, fixed index files are only reused for qemu backups where the total size never changes at the moment.
4.1.4 Feb 17, 2026
fixupdate proxmox-rest-server to 1.0.5 addressing a minor regression that resulted in some requests with auth issues being answered with HTTP code 400 "bad request" instead of the correct HTTP code 401 "unauthorized". The new rest-server also defaults to only checking the forwarded header in the…
featureproxy daemon: support configuration of real peer-ip header and allowed source through the PROXY_REAL_IP_HEADER and PROXY_REAL_IP_ALLOW_FROM environment variables. These variables can currently be set through overriding the proxmox-backup-proxy.service systemd unit. For example, to check the…
4.1.2 Jan 29, 2026
fixfix #7149: ui: user create: do not leak changing the realm for a new user into the pre-selected realm of the currently logged in user, as that might cause some UX friction and confusion on their next login.
fixfix recent regression that failed s3 refresh.
fixfix #7219: client: mount: align encryption key loading behavior to fallback to the default key location, just like all other commands.
featurepartially fix #6049: datastore: implement various optimizations for handling large datastore configs, including a cache for the datastore config to avoid re-parsing the whole config if not necessary.
otherchunk store: various code clean-ups for the chunk store iterator, chunk filename checks and "bad chunk" handling.
featureadd basic multiarch support to resulting package and executable locations.
featureswitch ACME implementation over to factored out one.
fixfix #6939: acme: support servers returning 204 for nonce requests.