Debian 11 – rsync backup job fails on permissions, ACLs, or xattrs

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Backup pipeline reports success/failure inconsistently and restores are incomplete.

Environment & Reproduction

Common when backing up mixed filesystems with ACL and extended attribute differences.

Root Cause Analysis

Rsync options and destination filesystem capabilities do not match source metadata requirements.

Quick Triage

Run dry-run with verbose logging to capture first failing path.

Step-by-Step Diagnosis

Inspect failing files for ownership, ACL, and xattr compatibility.

Solution – Primary Fix

Align destination mount options and use rsync flags that preserve required metadata safely.

Solution – Alternative Approaches

If metadata parity is impossible, use tar snapshots or filesystem-native backup tooling.

Verification & Acceptance Criteria

Backup completes with zero rsync error code and restore test matches expected metadata.

Rollback Plan

Revert to prior backup method if new rsync profile introduces data fidelity concerns.

Prevention & Hardening

Include periodic restore drills and metadata integrity checks in backup policy.

Related Errors & Cross-Refs

Related to Operation not permitted, failed to set times, and partial transfer warnings.

Related tutorial: View the step-by-step tutorial for Debian 11.

View all Debian 11 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Rsync metadata preservation and Debian backup strategy references.