---
title: "Borg"
date: 2025-05-23T09:14:36+02:00
tags:
  - 100DaysToOffload
draft: false
author: "Colmaris"
toc: true
---
## Créer un dépôt distant

*Ne pas oublié d'activité l'authentification par cléf pour SSH*

```shell
borg init -e none ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant
```

* `-e none` : signifie que le dépôt n'est pas chiffré, pour chiffré le dépôt on utilisera l'options `repokey`

## Créer une sauvegarde

```shell
borg create --verbose --stats --compression lz4  /repertoire/source ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant::nom-de-sauvegarde
```

## Lister les sauvegardes

```shell
borg list ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant
```

## Restaurer une sauvegarde

```shell
borg extract ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant::nom-de-la-sauvegarde-a-extraire /dossier/dextraction
```

## Automatisation

Placer le script dans `/etc/cron.daily/`pour une sauvegarde quotidienne vers 5h du matin. On peut aussi utiliser les dossier `cron.weekly`ou `cron.monthly` par exemple.

```shell
#!/bin/bash

# Setting this, so the repo does not need to be given on the commandline:
export BORG_REPO=ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant

# See the section "Passphrase notes" for more infos.
#export BORG_PASSPHRASE=''

# some helpers and error handling:
info() { printf "\n%s %s\n\n" "$( date )" "$*" >&2; }
trap 'echo $( date ) Backup interrupted >&2; exit 2' INT TERM

info "Starting backup"

# Backup the most important directories into an archive named after
# the machine this script is currently running on:

borg create                         \
    --verbose                       \
    --filter AME                    \
    --list                          \
    --stats                         \
    --show-rc                       \
    --compression lz4               \
    --exclude-caches                \
    --exclude 'home/*/.cache/*'     \
    --exclude 'var/tmp/*'           \
                                    \
    ::'{hostname}-{now}'            \
    /dossier/a/sauvegarder          \
    /dossier/a/sauvegarder          \
    /dossier/a/sauvegarder                       

backup_exit=$?

info "Pruning repository"

# Use the `prune` subcommand to maintain 7 daily, 4 weekly and 6 monthly
# archives of THIS machine. The '{hostname}-*' matching is very important to
# limit prune's operation to this machine's archives and not apply to
# other machines' archives also:

borg prune                          \
    --list                          \
    --glob-archives '{hostname}-*'  \
    --show-rc                       \
    --keep-daily    7               \
    --keep-weekly   4               \
    --keep-monthly  12              \
    --keep-yearly   5

prune_exit=$?

# actually free repo disk space by compacting segments

info "Compacting repository"

borg compact

compact_exit=$?

# use highest exit code as global exit code
global_exit=$(( backup_exit > prune_exit ? backup_exit : prune_exit ))
global_exit=$(( compact_exit > global_exit ? compact_exit : global_exit ))

if [ ${global_exit} -eq 0 ]; then
    info "Backup, Prune, and Compact finished successfully"
elif [ ${global_exit} -eq 1 ]; then
    info "Backup, Prune, and/or Compact finished with warnings"
else
    info "Backup, Prune, and/or Compact finished with errors"
fi

exit ${global_exit}
```