Borg¶

Field	Value
Purpose	BorgBackup-specific configuration — deduplicating archiver with compression and encryption
Repo	AmadlaOrg/Entities/Application/Backup/Borg
Entity URI	`amadla.org/entity/application/backup/borg@v1.0.0`
Parent type	Application/Backup

Schema¶

Property	Type	Description
`repository`	string	Repository path (local path or `ssh://user@host/path`)
`passphrase_secret`	string	Doorman secret reference for the repository passphrase
`compression`	string	Compression algorithm for archives (`none`, `lz4`, `zstd`, `zlib`, `lzma`)
`prune.keep_daily`	integer	Number of daily archives to keep
`prune.keep_weekly`	integer	Number of weekly archives to keep
`prune.keep_monthly`	integer	Number of monthly archives to keep
`prune.keep_yearly`	integer	Number of yearly archives to keep

Example¶

_type: amadla.org/entity/application/backup/borg@v1.0.0
_extends: amadla.org/entity/application/backup@v1.0.0
_body:
  schedule: "0 3 * * *"
  paths:
    - /etc
    - /home
    - /var/lib
  encryption:
    enabled: true
  repository: ssh://backup@storage.example.com/srv/borg/webserver01
  passphrase_secret: doorman://vault/backup/borg-passphrase
  compression: zstd
  prune:
    keep_daily: 7
    keep_weekly: 4
    keep_monthly: 6
    keep_yearly: 1

Consumers¶

Tool	How It Uses Application/Backup/Borg
lay	Installs the `borgbackup` package
weaver	Generates backup scripts and systemd timer units
enjoin-service	Enables/starts `borg-backup.timer`