✎ restic [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{ :logo:restic.png?130|Logo de Restic}}
====== Restic ======

**[[https://github.com/restic/restic|Restic]]** est un logiciel libre de [[:sauvegarde]] qui offre toutes les fonctionnalités qu'on attend d'un logiciel de sauvegarde modernes : incrémentation((la [[wpfr>Sauvegarde_(informatique)#Sauvegarde_incrémentielle_ou_incrémentale|sauvegarde incrémentielle]] permet de conserver les anciennes versions des fichiers sauvegardées, sans nécessiter de téléverser de nouveau les fichiers inchangés)), chiffrement((le chiffrement empêche tout tiers d'accéder à vos données, y compris le propriétaire de la solution de stockage)), compression, déduplication((la compression et la déduplication accélèrent les transferts et permettent aux sauvegardes d'occuper un minimum d'espace)), etc.

Il permet de sauvegarder sur :
  * un système de fichiers local
  * [[:Samba|SMB / CIFS]] (partages locaux, Windows, Linux ou MacOS)
  * [[:ssh#monter_un_repertoire_distant_navigation_via_sftp_secure_file_transfer_protocol|SFTP]] ([[:SSH]])
  * [[https://github.com/restic/rest-server|serveur HTTP REST]]
  * OpenStack Swift
  * Amazon S3
  * BackBlaze B2
  * Microsoft Azure Blob Storage
  * Google Cloud Storage
  * ... et surtout sur tout ce que supporte [[:Rclone]], ce qui le rend compatible avec à peu près [[https://github.com/rclone/rclone#storage-providers|tout ce qui existe]] en terme de stockage, local ou distant, avec les meilleures performances possibles dans chaque situation :
    * [[:WebDAV]]
    * [[:FTP]]
    * [[:Nextcloud]], [[:ownCloud]]
    * [[https://www.seafile.com|Seafile]]
    * OVH
    * Synology C2 Object Storage
    * Dropbox
    * Proton Drive
    * Internet Archive
    * put.io
    * etc.

Il s'utilise initialement en ligne de commande mais il existe diverses [[#interfaces graphiques]].

Il est relativement proche de [[:borgbackup|Borg Backup]] d'un point de vue utilisation et performances, mais ne nécessite aucun logiciel côté dépôt (serveur), ce qui le rend particulièrement versatile. Il utilise aussi son propre format de fichier ce qui a l'inconvénient de ne pas rendre les fichiers stockés dans les dépôts accessibles avec n'importe quel outil, mais qui a aussi et surtout l'avantage de permettre le chiffrement, la compression, la déduplication, et la sauvegarde des permissions et dates des fichiers quel que soit le système de fichier sous-jacent ou le protocole d'échange utilisé.

<note warning>
Ni **Restic**, ni **Restic Browser** ne sont malheureusement traduits en français pour le moment. Il est donc compliqué de les utiliser sans maîtriser un minimum l'anglais. N'hésitez pas à demander de l'aide sur le [[https://forum.ubunut-fr.org|forum]] si besoin !
</note>

===== Installation =====

**Restic** est disponible dans les [[:depots#dépôts officiels]] d'Ubuntu.\\ 
Pour l'installer il suffit donc d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>restic]].**

===== Utilisation =====

On peut afficher la liste des commandes disponibles en tapant simplement ''restic'' dans un [[:terminal]].

**Restic** permet de réaliser toutes sortes d'opérations mais on utilisera principalement ''init'' la première configuration, puis régulièrement la commande ''backup'' pour déclencher les sauvegardes (ou instantanés / //snapshots//).

Le paramètre ''-r'' (ou ''%%--%%repo'' en version longue) est très important : il permet de spécifier le dépôt (//**R**epository// en anglais) sur lequel on souhaite travailler.

Voir aussi **//(en)//** [[https://restic.readthedocs.io/|le guide d'utilisation]], avec des instructions détaillées pour chaque fournisseur.

==== Initialisation ====

Pour commencer à utiliser **restic** il faut en premier lieu initialiser un dépôt avec la commande ''[[https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html|restic init]]''. C'est sur celui-ci qu'on effectuera les sauvegardes. Sur le dépôts les sauvegardes sont organisées par [[:chemins|chemin]] local (celui des données qu'on sauvegarde, sur la machine locale) et nom d'hôte (le nom de la machine locale). On peut donc sauvegarder plusieurs fois un chemin similaire depuis différentes machines sur un même dépôt sans risque de tout mélanger.

Entrez la commande suivante  dans un [[:terminal]] :

restic -r sftp:serveur:/chemin/restic-repo init

Adaptez ''sftp:serveur:/chemin/restic-repo'' selon votre solution de stockage distant :

''sftp:'' selon le protocole choisi, ou ''rclone:'' pour un dépôt [[:rclone]], puis ''serveur:'' pour le nom d'hôte.

==== Sauvegarde ====

C'est la commande ''[[https://restic.readthedocs.io/en/stable/040_backup.html|restic backup]]'' qui permet de délencher une sauvegarde.

En ligne de commande, **restic** s'utilise un peu comme [[:rsync]] ou [[:rClone]].

<code>restic -r sftp:serveur:/chemin/restic-repo backup /chemin</code>

Commande à adapter comme ''init'' précédemment :
  * ''-r'' pour spécifier le dépôt sur lequel on souhaite travailler.
  * Le ''/chemin'' est celui du répertoire à sauvegarder.
  * On peut utiliser l'option ''[[https://restic.readthedocs.io/en/stable/040_backup.html#excluding-files|--exclude]]'' pour exclure certains fichiers ou répertoires
  * et l'option ''[[https://restic.readthedocs.io/en/stable/040_backup.html#dry-runs|--dry-run]]'' pour lancer un test sans effectuer réellement la sauvegarde.

La première fois qu'on lance cette commande, l'intégralité des données et compressée et sauvegardée. Par la suite avec la même commande on ne transfère que les données qui ont été modifiées, c'est donc beaucoup plus rapide.

==== Lister les sauvegardes ====

La commande ''[[https://restic.readthedocs.io/en/stable/045_working_with_repos.html#listing-all-snapshots|snapshots]] '' permet de lister les instantanés :
<code>restic -r sftp:serveur:/chemin/restic-repo snapshots</code>

Cette commande retourne un tableau dont la première colonne affiche l'identifiant de chaque instantané.

==== Restauration ====

La commande ''[[https://restic.readthedocs.io/en/stable/050_restore.html|restic restore]]'' permet de restaurer n'importe quel instantané précis.

<code>restic -r sftp:serveur:/chemin/restic-repo identifiant_instantané %%--%%target /chemin</code>

* L%%'%%''identifiant_instantané'' est un numéro à 8 chiffres hexadécimaux, récupérés en listant les sauvegardes à l'étape précédente.
  * Le ''/chemin'' n'est ici pas forcément celui du contenu sauvegardé, mais celui vers lequel on veut restaurer la sauvegarde.

On peut ainsi restaurer n'importe quelle sauvegarde à l'emplacement de son choix.

===== Interfaces graphiques =====

Il existe de nombreuses interfaces graphiques permettant d'utiliser et d'explorer facilement les dépôts **restic** ;

* [[https://github.com/emuell/restic-browser|Restic Browser]] (GTK)
  * [[https://github.com/netinvent/npbackup|NetPerfect Backup]]
  * [[https://github.com/GPh83/resticterm|resticterm]] : une interface graphique en [[:terminal]] (particulièrement pratique pour les serveurs ou les machines distantes).
  * [[https://github.com/swampapp/swamp|Swamp]] (GTK) : bien intégré à GNOME mais semble abandonné.

Voir [[https://github.com/rubiojr/awesome-restic?tab=readme-ov-file#apps|cette liste]] plus complète.

===== Voir aussi =====

* **//(en)//** [[https://github.com/restic/restic|sources et site officiel]]
  * **//(en)//** [[https://restic.readthedocs.io/en/stable/|documentation]]

----
//Contributeur : [[:utilisateurs:krodelabestiole]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : D F Q R E Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported