Key details

  1. Released October 18, 2026, according to the pgBackRest community's PostgreSQL announcement.
  2. Restore checksum-page-error default is y: invalid page checksums stop restore and leave the target cluster incomplete until rerun.
  3. Backup checksum-page-error default is n, so do not assume all backup commands abort on checksum warnings.
  4. Expire refuses to remove a retention boundary when the oldest remaining backup would have invalid page checksums.
  5. Operators can set checksum-page-error=n to warn instead of erroring for affected commands, accepting risk explicitly.
  6. Additional release features: GCS Workload Identity Federation, object-store read prefetch, OpenSSL 4 and illumos builds.
  7. PostgreSQL 19 RC1 support was already present in pgBackRest 2.59.2; do not describe it as newly introduced in 2.60.

What builders should take away

  1. Before upgrading production backup automation, test a deliberately corrupted page-checksum fixture in a disposable PostgreSQL environment; verify restore failure handling and cleanup.
  2. Separate restore and backup defaults for checksum-page-error in runbooks; they are not identical.
  3. Alert on failed expire jobs and investigate checksum integrity rather than blindly forcing retention cleanup.
  4. Preserve clean recovery points and rehearse recovery before choosing warning-only mode.
  5. If using GCS, review Workload Identity Federation instead of long-lived service account keys; benchmark prefetch on your actual object store.

What changed

On October 18, 2026, pgBackRest 2.60.0 introduced checksum-page-error handling that changes default behaviour during restore and backup expiration. A restore now fails and stops when any restored file contains an invalid page checksum; the target PostgreSQL cluster is incomplete and cannot be started until restore is rerun. The expire command refuses to expire the oldest retained backup if doing so would leave the retained set with checksum errors, preventing associated archive expiry. Operators may choose checksum-page-error=n to log warnings rather than errors. Other 2.60 changes include GCS Workload Identity Federation, object-store multi-file/range prefetch and OpenSSL 4 build support.

Why it matters

Backup integrity checks are only useful if their failures change decisions. This release makes checksum corruption a hard recovery and retention boundary by default, rather than allowing operators to overlook warnings and continue. That protects against silently booting a damaged restored cluster or expiring a potentially needed clean recovery point, but it can also interrupt scripted restores and retention workflows that previously succeeded. Database operators should test their failure procedures, especially when time to recovery matters.

Restores can now fail instead of leaving warnings

pgBackRest's October 18 announcement explicitly says restore stops if a restored file contains an invalid PostgreSQL page checksum. The partially restored data directory is incomplete and the restore must be rerun. The documented restore default for checksum-page-error is y; the same option can be disabled to warn instead, but that knowingly accepts a recovery-integrity risk. This is separate from backup-time checksum validation, whose command-reference default for checksum-page-error remains n.

Retention now guards against expiring the wrong recovery point

The expire command refuses to expire the oldest retained backup if the resulting oldest retained backup would contain checksum errors; associated archive expiration is also prevented. That makes backup pruning sensitive to corruption history, so storage alerts and automated cleanup need to distinguish a deliberate safety stop from a broken scheduler.

Cloud storage and build changes are operationally relevant

Version 2.60 adds prefetch of multi-file and byte-range reads from object stores and GCS Workload Identity Federation, reducing dependence on static credentials for compatible Google Cloud deployments. OpenSSL 4 and illumos build support broaden supported environments. The announcement does not establish independent throughput gains, so performance should be tested against each repository and restore workload.

What to watch next

  • Whether operators report unexpected restore/expiry failures on upgrade and whether the project adjusts diagnostics.
  • Independent measurements of object-store prefetch effects on backup and restore workloads.
  • Subsequent bug fixes around page-checksum error handling and backup retention.

Still unclear

  • The project announcement and command reference establish intended semantics; independent production fault-injection testing has not been verified.
  • Behaviour applies to databases with page checksums available and relevant invalid pages, not every PostgreSQL backup.
  • Performance benefit from prefetch varies with storage backend and workload.

Sources

Direct reading behind this dossier.

4 sources
pgBackRest 2.60.0 Released
PostgreSQL.org / pgBackRest Community primary

Release announcement, checksum restore/expire warning, GCS federation and prefetch features.

pgBackRest 2.60.0 release mirror
newreleases.io independent release mirror

Independent syndication of upstream release notes, not an independent operational test.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment