Configuration

fsbackup.conf

Configuration reference for /etc/fsbackup/fsbackup.conf — snapshot paths, mirror settings, and retention.

The main configuration file lives at /etc/fsbackup/fsbackup.conf. All scripts source it at startup.

Example

SNAPSHOT_ROOT="/backup/snapshots"
SNAPSHOT_MIRROR_ROOT="/backup2/snapshots"
MIRROR_SKIP_CLASSES=""

Keys

`SNAPSHOT_ROOT`

Path to the primary snapshot storage directory. Must be on a CMR drive. Subdirectories daily/, weekly/, monthly/, and annual/ are created automatically.

SNAPSHOT_ROOT="/backup/snapshots"

`SNAPSHOT_MIRROR_ROOT`

Path to the mirror snapshot storage directory (second drive). Set to empty to disable mirroring entirely.

SNAPSHOT_MIRROR_ROOT="/backup2/snapshots"

Space-separated list of class names to exclude from mirroring. Leave empty (or omit) to mirror all classes. Set to "class3" if you want to skip large archives and save space on your secondary drive — but mirroring class3 is fully supported if you have the space.

MIRROR_SKIP_CLASSES=""                 # mirror everything (default)
MIRROR_SKIP_CLASSES="class3"          # skip large archives
MIRROR_SKIP_CLASSES="class2 class3"   # skip multiple classes

Snapshot path structure

Snapshots are stored at:

<SNAPSHOT_ROOT>/<tier>/<date>/<class>/<target>/

Tier	Date format	Example
`daily`	`YYYY-MM-DD`	`daily/2025-03-15/class1/myapp.data/`
`weekly`	`YYYY-Www`	`weekly/2025-W11/class1/myapp.data/`
`monthly`	`YYYY-MM`	`monthly/2025-03/class1/myapp.data/`
`annual`	`YYYY`	`annual/2025/class1/myapp.data/`

Adding remote hosts

How to initialize a new remote host for fsbackup and add it to targets.yml.

targets.yml

How to define backup targets in targets.yml — hosts, sources, classes, and rsync options.