Comment transférer une application Yunohost d'un serveur vers un autre.

2025-09-20

Pour exporter et importer une application dans YunoHost, vous utilisez le système de sauvegarde et de restauration intégré. Ce processus crée une archive de l'application que vous pouvez ensuite transférer et restaurer sur le même serveur YunoHost ou un autre.

Voici les étapes générales et quelques points importants à garder à l'esprit.

 

1. Exporter (Créer une sauvegarde)

 

Vous pouvez créer une sauvegarde d'une application via l'interface d'administration web ou la ligne de commande.

Via l'interface d'administration web :

  1. Connectez-vous à votre interface d'administration YunoHost.

  2. Allez dans Sauvegardes.

  3. Cliquez sur Nouvelle sauvegarde.

  4. Un menu s'affichera où vous pourrez choisir quoi sauvegarder. Pour une application spécifique, décochez toutes les autres options (Configuration système, Données utilisateur, Données de messagerie, etc.) et ne sélectionnez que l'application que vous souhaitez exporter.

  5. Cliquez sur Créer la sauvegarde.

Via la ligne de commande :

  1. Connectez-vous à votre serveur en SSH.

  2. Utilisez la commande yunohost backup create avec l'option --apps pour spécifier l'application que vous voulez sauvegarder.

    Bash 
    yunohost backup create --apps <nom_de_l_application>

    (Remplacez <nom_de_l_application> par le nom de l'application, par exemple wordpress ou nextcloud).

  3. La sauvegarde sera créée dans le répertoire /home/yunohost.backup/archives/.

 

2. Télécharger l'archive de sauvegarde

 

Une fois la sauvegarde créée, vous devez télécharger le fichier d'archive .tar depuis votre serveur vers votre machine locale.

Via l'interface d'administration web :

  1. Allez dans Sauvegardes.

  2. Trouvez l'archive de sauvegarde que vous venez de créer.

  3. Cliquez sur le bouton Télécharger à côté.

  4. Pour les archives volumineuses, l'interface web peut ne pas être la solution idéale.

Via la ligne de commande (recommandé pour les gros fichiers) :

  1. Utilisez un outil comme scp pour copier le fichier depuis votre serveur vers votre ordinateur.

    Bash 
    scp admin@votre.domaine.tld:/home/yunohost.backup/archives/<nom_de_l_archive>.tar ./

    (Remplacez admin par votre nom d'utilisateur, votre.domaine.tld par le domaine ou l'adresse IP de votre serveur, et <nom_de_l_archive>.tar par le nom complet du fichier de sauvegarde).

 

3. Importer (Restaurer la sauvegarde)

Jusqu'ici il n'y a pas de problème. Mais pour l'import c'est un peu plus difficile car il faut le faire. Voici le tuto qui n'a pas marché pour moi

Pour importer l'application sur un nouveau serveur YunoHost, vous devez d'abord y transférer le fichier de sauvegarde, puis le restaurer.

Télécharger le fichier de sauvegarde :

  1. Transférez le fichier de sauvegarde .tar dans le répertoire /home/yunohost.backup/archives/ du serveur de destination.

  2. Utilisez un outil comme scp pour cela.

    Bash 
    scp /chemin/vers/votre/archive_locale.tar admin@votre.nouveau.domaine.tld:/home/yunohost.backup/archives/

Maintenant je vous donne comment j'ai fait

  1. Transférez l'archive xxx.tar avec  filezilla en avec le compte debian dans /home
  2. ssh debian@ip 
  3. sudo su
  4. # cp /home/xxx.tar /home/yunohost.backup/archives

Restaurer la sauvegarde :

  1. Avant de restaurer une application, le domaine sur lequel elle était installée sur le serveur d'origine doit être déjà configuré sur le nouveau serveur.

  2. Vous ne pouvez pas restaurer une application qui est déjà installée. Si l'application existe sur le nouveau serveur, vous devez d'abord la désinstaller.

  3. Vous pouvez restaurer l'application depuis l'interface web ou la ligne de commande.

Via l'interface d'administration web :

  1. Allez dans Sauvegardes.

  2. Sélectionnez l'archive que vous avez téléchargée.

  3. Choisissez l'application spécifique que vous souhaitez restaurer et cliquez sur Restaurer.

Via la ligne de commande :

  1. Connectez-vous au serveur de destination en SSH.

  2. Exécutez la commande yunohost backup restore.

    Bash 
    yunohost backup restore <nom_de_l_archive> --apps <nom_de_l_application>

    (Remplacez <nom_de_l_archive> par le nom du fichier sans l'extension .tar, et <nom_de_l_application> par le nom de l'application).

 

Points importants à considérer :

 

  • Contenu de la sauvegarde : Une sauvegarde standard d'application YunoHost inclut la configuration de l'application, sa base de données et ses fichiers de données.

  • Domaine et URL : Le domaine et l'URL de l'application doivent être configurés sur le nouveau serveur avant que vous puissiez restaurer la sauvegarde. Cela veut dire que le DNS doit pointer sur le nouveau serveur

  • Version de YunoHost : Faites attention à la compatibilité des versions. Les sauvegardes de versions plus anciennes de YunoHost peuvent ne pas être compatibles avec les plus récentes. Si vous migrez depuis une très ancienne version, vous pourriez avoir besoin de procéder à la mise à jour par étapes.

  • Migration manuelle : Pour certaines applications, en particulier celles personnalisées ou avec des configurations complexes, une migration manuelle peut être nécessaire. Cela peut impliquer d'exporter et d'importer manuellement des bases de données (par exemple, avec mysqldump ou pg_dump) et de copier des fichiers avec rsync.

2030-09-24