YunoHost : l’auto-hébergement facile sur Raspberry Pi

Après des années à configurer des serveurs Linux à la main, j’étais curieux de voir ce que YunoHost pouvait faire. Il transforme un Raspberry Pi en serveur auto-hébergé en quelques minutes, et permet de déployer des applications comme WordPress, Nextcloud ou Jellyfin sans se prendre la tête.

YunoHost est une distribution Linux conçue pour l’auto-hébergement. Une fois installée sur un Raspberry Pi, les applications peuvent être déployées et gérées directement via son interface web, sans avoir à configurer chaque service manuellement.

On va voir ensemble comment installer YunoHost sur un Raspberry Pi, faire la configuration initiale, et lancer votre première application en quelques étapes.

Si vous débutez avec Raspberry Pi ou Linux, j’ai quelque chose qui peut vous aider !
Téléchargez ma fiche mémo des commandes Linux gratuitement – c’est un guide de référence rapide avec toutes les commandes essentielles dont vous aurez besoin utiliser votre Raspberry Pi. Cliquez ici pour l’obtenir gratuitement !

Présentation de YunoHost

Si vous voulez héberger une application comme un site WordPress sur Raspberry Pi, ça demande pas mal d’étapes. Installation, configuration, déploiement sur une plateforme publique ou privée… c’est vite compliqué.

YunoHost est là pour simplifier tout ça. C’est une plateforme (basée sur Debian) qui permet d’installer et de déployer vos applications en un clic.

YunoHost est un OS assez méconnu parce qu’il est un peu à part. On peut le comparer à un gestionnaire de conteneurs Docker pour vos applications, où chaque appli tourne de façon isolée.

Maintenant qu’on a une idée claire de ce qu’est YunoHost, passons aux choses sérieuses. Avant de commencer l’installation, voici ce dont vous aurez besoin.

Matériel et logiciels nécessaires

Pour suivre ce guide, il vous faut :

• Un Raspberry Pi : YunoHost supporte les Raspberry Pi 5, Pi 4 et Pi 3.
• Une carte micro-SD ou une clé USB : au choix, du moment qu’elle fait au moins 16 Go (l’image OS dépasse les 7 Go). Si vous avez besoin d’en acheter une, retrouvez nos recommandations ici.
• Une connexion filaire : dans ce tutoriel, on part du principe que votre Pi est connecté à votre réseau via un câble Ethernet.
• Clavier et souris (optionnel) : si vous ne pouvez pas utiliser une connexion filaire et que le Wi-Fi n’est pas configuré, vous pouvez brancher le Pi sur un écran et finir la configuration directement depuis l’interface.

Côté logiciels, il vous faut juste :

• L’image ISO de YunoHost : la dernière version pour Raspberry Pi (on voit comment la récupérer juste après).
• Raspberry Pi Imager ou Balena Etcher : pour flasher l’image sur votre carte. Utilisez celui que vous préférez. J’ai un guide complet sur Raspberry Pi Imager si besoin.

C’est bon, on a tout ce qu’il faut. On peut démarrer l’installation.

Installer et configurer YunoHost sur Raspberry Pi

On va passer en revue chaque étape pour installer et configurer YunoHost sur votre Raspberry Pi. Pour info, j’utilise un Raspberry Pi 4 pour ce tutoriel.

Télécharger l’image YunoHost

Première étape : récupérer la dernière version de l’image YunoHost pour votre Raspberry Pi. C’est rapide, moins de 5 minutes.

• Rendez-vous sur la page d’installation de YunoHost.
  Vous verrez la liste des appareils compatibles.
  Sélectionnez « Raspberry Pi ».
  
  
  
• Faites défiler jusqu’à la section « Download the YunoHost Image ».
  Cliquez sur le bouton Download (le numéro de version peut varier) pour télécharger l’image.
  Pour ce tutoriel, j’ai téléchargé la version 12.0.16.
  
  

Note : la procédure est différente pour un Raspberry Pi Zero, Pi 1 ou Pi 2. Pour ces modèles, il faut d’abord installer Raspberry Pi OS, puis suivre ce tutoriel.

Flasher YunoHost sur une carte SD

Une fois l’image téléchargée, on va la flasher sur la carte SD avec Raspberry Pi Imager :

• Lancez Raspberry Pi Imager et faites les sélections suivantes.
• Device : choisissez votre modèle de Raspberry Pi (Pi 5, Pi 4 ou Pi 3).
• OS : faites défiler jusqu’en bas de la liste et sélectionnez Use custom.
  
• Quand la fenêtre s’ouvre, sélectionnez l’image téléchargée.
  Elle devrait s’appeler quelque chose comme « yunohost-bookworm-12.0.16-rpi-stable.img.gz ».
  (Pas besoin de la décompresser, on l’utilise telle quelle.)
• Storage : choisissez votre carte SD ou clé USB. Vérifiez bien que vous sélectionnez le bon support, Imager va formater le périphérique choisi.
• Customisation : on passe cette section, rien à modifier ici.
• Writing : cliquez sur WRITE pour lancer le flash.
  

Attendez quelques minutes que l’écriture se termine. Une fois que c’est bon, retirez la carte SD (ou la clé USB) de votre ordinateur et insérez-la dans le Raspberry Pi.

Premier démarrage

La carte SD est prête. Il ne reste plus qu’à :

• Insérer la carte dans le Pi.
• Brancher l’alimentation.
• Connecter un câble Ethernet pour relier le Pi à votre réseau.

Si vous ne pouvez pas utiliser une connexion filaire, branchez le Pi sur un écran et terminez la configuration depuis là. Vous pouvez aussi vous connecter à un réseau Wi-Fi pour activer l’accès SSH.

Note : l’Ethernet est vraiment plus simple que le Wi-Fi ici. Si vous n’avez pas le choix, il faudra configurer le Wi-Fi en ligne de commande. Consultez notre article : Comment configurer le Wi-Fi sur Debian (en anglais) et allez directement à la dernière section pour les commandes.

Si tout se passe bien, vous devriez pouvoir accéder à l’adresse suivante depuis n’importe quel appareil sur le même réseau que votre Pi : http://yunohost.local
(Si ça ne fonctionne pas, essayez directement avec l’adresse IP du Pi.)
Vous aurez peut-être une alerte de sécurité au premier accès, c’est normal. Cliquez sur Advanced > Proceed.

La page d’administration de YunoHost s’ouvre.
Acceptez les conditions et cliquez sur Begin. La configuration peut commencer.

Configurer un nom de domaine

La première étape de configuration consiste à définir un nom de domaine pour votre serveur YunoHost.

Trois options s’offrent à vous :

• Utiliser un domaine que vous possédez déjà (en général payant).
• Obtenir un domaine gratuit via le projet YunoHost.
• Garder le nom de domaine local actuel pour faire des tests.

Si vous choisissez la deuxième option, un formulaire apparaît pour saisir le nom de domaine souhaité et un mot de passe de récupération.
YunoHost s’occupe du reste.

Une fois que c’est fait, cliquez sur Next pour passer à l’étape suivante : la création de votre premier utilisateur admin.

Créer l’utilisateur admin

La fenêtre suivante vous demande un nom d’utilisateur, un nom complet et un mot de passe pour créer le compte admin :

Remplissez le formulaire (respectez les consignes pour le mot de passe) et cliquez sur Next.
Un avertissement s’affiche avant de lancer le processus de post-installation (création du domaine, de l’utilisateur et configuration générale) :

Cliquez sur OK pour lancer la post-installation.
Soyez patient, ça prend quelques minutes.

Une fois le processus terminé, l’écran de connexion apparaît.
Utilisez les identifiants admin créés à l’étape précédente pour vous connecter.

Bravo, la configuration est terminée !
On va maintenant faire un tour de l’interface d’administration.

Premier tour de l’interface d’administration

Une fois connecté, vous avez accès à tout ce qu’il faut pour gérer votre serveur : les utilisateurs, les domaines (oui, plusieurs domaines sont supportés), les applications, et même les mises à jour système, le tout depuis une interface claire et facile à prendre en main.

Voici les deux sections essentielles à connaître : Utilisateurs et Domaines.

Gestion des utilisateurs

En tant qu’admin, vous gérez tous les utilisateurs de votre serveur YunoHost depuis l’onglet Users. Il existe deux types d’utilisateurs :

• Utilisateurs admin : ils peuvent gérer les autres utilisateurs, les applications et les domaines.
• Utilisateurs standard : créés par l’admin, ils accèdent uniquement aux applications pour lesquelles l’admin leur a donné les droits.

Voici ce qu’on peut faire depuis cette interface :

1. Voir les utilisateurs existants : ils apparaissent sous forme de liste. Cliquez sur un utilisateur pour modifier ses droits, ses infos ou le supprimer.
2. Rechercher un utilisateur : si vous avez un compte par application (comme moi), la barre de recherche devient vite indispensable.
   
   
3. Ajouter de nouveaux utilisateurs : vous pouvez créer des comptes, mais aussi importer ou exporter des utilisateurs depuis une autre instance YunoHost. Très pratique lors d’une migration.
   
   
   
4. Gérer les groupes et les permissions : vous pouvez regrouper des utilisateurs (par exemple, les membres de votre famille), gérer les droits par utilisateur ou par groupe, et définir qui accède à quelle application. Vraiment pratique !
   
   

Gestion des domaines

Comme pour les utilisateurs, la gestion des domaines est très simple. Un domaine, c’est en gros le point d’entrée vers vos applications.

Vous pouvez par exemple faire pointer deux domaines différents vers deux applications différentes sur le même serveur. Ce schéma illustre bien le principe :

Les options de gestion des domaines se trouvent dans l’onglet Domains sur l’écran d’accueil.

Comme vous pouvez le voir, on peut ajouter un nouveau domaine ou modifier la configuration des domaines existants.

La configuration des domaines est un sujet assez technique qui demande des connaissances en réseau, donc on ne va pas s’y attarder ici. Mais si vous êtes un utilisateur avancé et que ça vous intéresse, l’option est là (cet article vous donnera plus de détails).

Mises à jour système

Comme sur n’importe quel OS, garder ses paquets à jour est essentiel pour la sécurité et la stabilité du système. YunoHost propose une interface claire pour ça.

Allez dans System Updates depuis le menu principal, et cliquez sur Upgrade all packages en bas de page.
Une fois terminé, un redémarrage est recommandé pour être sûr que tout est bien pris en compte.

Petit bonus : depuis ce même onglet, vous pouvez aussi gérer les mises à jour de vos applications. Comme ça, tout ce que vous hébergez tourne toujours sur la version la plus récente et la plus sécurisée.

On a fait le tour de l’interface d’administration. Passons maintenant à la pratique et installons notre première application sur le serveur YunoHost.

Héberger sa première application sur YunoHost

Pour ce tutoriel, j’ai choisi WordPress, parce que j’avais envie d’héberger mon blog perso. Vous pouvez faire pareil ou choisir une autre application selon vos besoins.

Installer WordPress

Installer une application via l’interface YunoHost, c’est vraiment simple.
Voici les étapes :

• Depuis l’écran d’accueil de l’interface admin, allez dans l’onglet Applications.
  
  
• Une nouvelle page s’ouvre avec la liste de vos applications installées.
  Cliquez sur « Install an app » en haut à droite.
  
  
• Le catalogue d’applications YunoHost s’affiche. Tapez « WordPress » dans la barre de recherche, puis cliquez sur l’application quand elle apparaît.
  
  
• Une page de détails sur l’application s’ouvre. Prenez le temps de la lire, puis faites défiler jusqu’en bas pour remplir les paramètres d’installation.
  
  
  La plupart des options peuvent rester par défaut. Pour ma part, j’ai juste changé le Label de l’application en « PersonalBlog » et laissé le reste tel quel.
  
• Cliquez sur Install. L’installation démarre. Selon l’application choisie, ça peut prendre quelques minutes.
  
  
• Une fois l’installation terminée, l’application apparaît dans la liste des applications installées. Félicitations ! Vous venez d’installer et d’héberger (oui, c’est déjà en ligne !) votre première application avec YunoHost.
  
  

On va maintenant voir comment accéder à notre blog WordPress.

Accéder à l’application

Accéder à vos applications est simple, que vous soyez admin, utilisateur ou simple visiteur. Voici les trois façons de faire :

• Option 1 : via l’interface d’administration (Admins)
• Option 2 : via l’interface utilisateur (Users)
• Option 3 : via l’URL de l’application (Visitors)

On détaille chaque option.

Option 1 : via l’interface d’administration (admins)

En tant qu’admin, vous avez accès à toutes les applications du serveur. La façon la plus directe d’y accéder, c’est depuis l’interface d’administration.

• Allez dans le menu Applications et cliquez sur l’app que vous voulez ouvrir. Vous verrez les détails (version, infos, etc.). Pour lancer l’application, cliquez sur « Open this app » en haut à droite.
  
  
• Votre blog s’ouvre dans un nouvel onglet. Pour l’instant, vous verrez un site template créé par les développeurs de YunoHost.
  
  

Option 2 : via l’interface utilisateur (utilisateurs)

• Si vous avez créé un utilisateur avec accès à cette application, il peut y accéder via l’interface utilisateur de YunoHost. Pour y accéder, cliquez sur le bouton bleu « User interface » dans l’interface admin.
  
  
• Votre interface utilisateur personnalisée s’ouvre. Vous pouvez aussi accéder directement à votre domaine de base, ce qui affiche l’écran de connexion de l’interface utilisateur.
  
  
  
• Pour accéder à une application, cliquez sur son icône (ici, le site WordPress).
• Le blog s’ouvre dans un nouvel onglet, avec le même template par défaut.
  
  

Option 3 : via l’URL de l’application (visiteurs)

• Si vous voulez que votre blog soit accessible publiquement, il vous faut un lien que n’importe qui peut utiliser. C’est l’URL de l’application, au format : « https://<votre-domaine>/<chemin> » (le chemin est celui que vous avez défini lors de l’installation).
  
  Dans mon cas, c’est https://rpitips.nohost.me/blog.
  
• Ouvrez ce lien dans n’importe quel navigateur et vous accédez à votre blog.
  
  

Et voilà, c’est la fin de ce tutoriel ! Vous savez maintenant comment héberger vos applications avec un minimum de configuration grâce à YunoHost. Il y a encore plein de choses à explorer. Si vous voulez aller plus loin, je vous recommande de consulter la documentation officielle de YunoHost.

Merci d’avoir lu cet article. À bientôt pour la suite !

Ressources supplémentaires pour votre Raspberry Pi

Initiation au Raspberry Pi en vidéo
Si vous débutez et voulez passer rapidement à la vitesse supérieure, j’ai exactement ce qu’il vous faut.
Regardez ma formation vidéo qui vous aidera à démarrer du bon bien, choisir votre matériel, installer les meilleures applications et vous lancer directement dans vos premiers projets avec mon aide.
Regarder les vidéos dès maintenant

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources