Softcloud Wiki

Installer YunoHost Raspberry Pi

Sun, 08 Nov 2026 14:23:30 +0100

Pré-requis

Un Raspberry Pi 3 ou 4 ;
Une alimentation électrique (soit un adaptateur, soit un câble microUSB) pour alimenter la carte ;
Une carte microSD : au moins 16Go de capacité, classe « A1 » hautement recommandée (comme par exemple cette carte SanDisk A1) ;
Un fournisseur d'accès à Internet correct, de préférence avec une bonne vitesse d’upload ;
Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet ;
Un ordinateur pour lire ce guide, flasher l'image et accéder à votre serveur.

Télécharger l'image YunoHost

Si vous souhaitez vérifier la validité de nos images signées, vous pouvez télécharger notre clé publique.

Raspberry Pi

64 bits - Rpi 3, 4

Checksum

Signature

Télécharger v.11.0.10

Flasher l'image YunoHost

Maintenant que vous avez téléchargé l’image de YunoHost, vous devez la mettre sur une carte microSD

Téléchargez Etcher pour votre système d'exploitation et installez-le.

Branchez votre carte microSD, sélectionnez votre image et cliquez sur « Flash ».

Démarrer la carte

Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre carte).
- Pour les utilisateurs et utilisatrices souhaitant configurer la carte pour la connecter via le WiFi à la place, voir cet exemple.
Mettez la carte SD dans le serveur.
(Facultatif) Il est possible de brancher un écran et un clavier sur votre serveur en cas de soucis, pour vérifier que le processus de démarrage (boot) se passe bien, ou encore pour avoir un accès direct en console.
Branchez l'alimentation.
Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage.
Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box Internet) que votre serveur.

Lancer la configuration initiale

Si vous êtes en train de restaurer une sauvegarde YunoHost, vous devez sauter cette étape et vous référer à la section Restaurer durant la post-installation à la place de cette étape de configuration initiale.

Dans un navigateur web, tapez dans la barre d'adresse https://yunohost.local
(utilisez
yunohost-2.local
, etc. s'il y a plusieurs serveurs YunoHost sur le réseau).

Si ça ne fonctionne pas, vous devez chercher l'adresse IP locale du serveur. L'adresse ressemble typiquement à

192.168.x.y

, et vous devriez taper

https://192.168.x.y

dans la barre d'adresse du navigateur.

Lors de la première visite, vous rencontrerez très probablement un avertissement de sécurité lié au certificat utilisé. Pour le moment, votre serveur utilise un certificat auto-signé. Vous pourrez plus tard ajouter un certificat automatiquement reconnu par les navigateurs comme décrit dans la page sur les certificats. En attendant, ajoutez une exception de sécurité pour accepter le certificat actuel. Toutefois, s'il vous plaît, ne prenez pas l'habitude d'accepter ce genre d'alerte de sécurité !

Vous devriez ensuite obtenir cette page :

Capture d'écran de la page de configuration initiale

Domaine principal

C’est le nom de domaine qui permettra l’accès à votre serveur ainsi qu’au portail d’authentification des utilisateurs. Vous pourrez ensuite ajouter d'autres domaines, et changer celui qui sera le domaine principal si besoin.

Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en .nohost.me / .noho.st / .ynh.fr (exemple :
```
homersimpson.nohost.me
```
). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contrôle complet sur votre configuration DNS.
Si en revanche vous avez déjà votre propre nom de domaine, vous souhaitez probablement l'utiliser. Vous aurez donc besoin ensuite de configurer les enregistrements DNS comme expliqué ici.

Oui, vous devez configurer un nom de domaine. Si vous n'avez pas de nom de domaine et que vous n'en voulez pas en .nohost.me, .noho.st ou .ynh.fr, vous pouvez utilisez un « faux » domaine comme par exemple

yolo.test

et modifier votre fichier

/etc/hosts

sur votre ordinateur local pour que ce domaine pointe vers l'IP de votre serveur, comme expliqué ici.

Premier compte utilisateur

Depuis YunoHost 11.1, le premier compte utilisateur est créé à cette étape. Il vous faudra choisir un nom d'utilisateur et un mot de passe raisonablement complexe. (Nous ne pouvons que souligner l'importance du choix d'un mot de passe robuste !) Ce compte utilisateur sera ajouté au groupe Admins, et pourra se connecter au portail utilisateur, à la webadmin, et se connecter via SSH ou SFTP. Les admins recevront aussi les mails envoyés à

root@votredomaine.tld

admin@votredomaine.tld

: ces emails peuvent être utilisés pour envoyer des informations ou des alertes techniques. Vous pourrez plus tard ajouter d'autres comptes utilisateur supplémentaire, qu'il est aussi possible d'ajouter au groupe Admins.

Ce compte remplace l'ancien compte

admin

, qui est peut être toujours mentionné dans certaines pages de documentation. Dans ce cas, remplacez simplement

admin

par votre identifiant.

Lancer le diagnostic

Une fois la postinstall terminée, vous devriez pouvoir vous connecter à la webadmin en utilisant les identiants du premier compte utilisateur que vous venez de créer.

Le système de diagnostic est conçu pour fournir un moyen facile de valider que tous les aspects critiques de votre serveur sont proprement configurés et pour vous guider dans la résolution des problèmes soulevés. Le diagnostic se lance deux fois par jour et envoie une alerte si un dysfonctionnement est détecté.

N.B. : ne partez pas en courant ! La première fois que vous lancerez le diagnostic, il est assez normal d'avoir plusieurs alertes rouges ou jaunes car vous devez généralement configurer les enregistrements DNS (si vous n'utilisez pas un domaine

.nohost.me

.noho.st

.ynh.fr

), ajouter un fichier de swap et/ou configurer la redirection des ports.

Si une alerte n'est pas pertinente (par exemple parce que vous ne pensez pas utiliser une fonctionnalité spécifique), il est tout à fait convenable d'indiquer le dysfonctionnement comme « À ignorer » en allant dans l'administration web > Diagnostic, et en cliquant sur le bouton « Ignorer » pour ce dysfonctionnement spécifique.

Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagnostic. Vous devriez obtenir un écran comme celui-ci :

Capture d'écran du panneau de diagnostic

Obtenir un certificat Let's Encrypt

Une fois que vous avez configuré, si nécessaire, les enregistrements DNS et la redirection de ports, vous devriez être en mesure d'installer un certificat Let's Encrypt. Ceci permettra de supprimer l'étrange alerte de sécurité vue plus tôt.

Pour plus d'instructions détaillées, ou pour en savoir plus à propos des certificats SSL/TLS, voir la page correspondante ici.

Capture d'écran du panneau pour installer un certificat Let's Encrypt

Félicitations !

Vous avez maintenant un serveur plutôt bien configuré. Si vous découvrez YunoHost, nous vous recommandons de jeter un œil à la visite guidée. Vous devriez aussi être en mesure d'installer vos applications favorites. N'oubliez pas de prévoir des sauvegardes !

Guide d'administration

Sun, 08 Nov 2026 14:23:29 +0100

Choisir son mode et fournisseurs d'autohébergement

Sun, 08 Nov 2026 14:23:29 +0100

Vous pouvez vous auto-héberger à la maison (sur un petit ordinateur), ou sur un serveur distant. Chaque solution a ses avantages et inconvénients :

À la maison, par exemple sur une carte ARM ou un ancien ordinateur

Vous pouvez vous héberger chez vous, sur une carte ARM ou un vieil ordinateur, connecté à votre box internet.

Avantages : vous aurez un contrôle physique sur la machine et avez seulement besoin d'acheter le matériel initial ;
Inconvénients : il vous faudra configurer manuellement votre box internet et serez possiblement limité par certains aspects de votre fournisseur d'accès à Internet.

À la maison, derrière un VPN

Un VPN est un tunnel chiffré entre deux machines. En pratique, cela permet de faire « comme si » une machine était connectée depuis ailleurs. Ceci permet de s'auto-héberger à la maison tout en contournant les limitations du fournisseur d'accès à Internet. Voir aussi le projet Brique Internet et la FFDN.

Avantages : vous aurez un contrôle physique sur la machine, et le VPN permettra de cacher votre trafic vis-à-vis de votre FAI ainsi que de contourner ses limitations ;
Inconvénients : il vous faudra payer des frais mensuels pour le VPN.

Sur un serveur distant (VPS ou serveur dédié)

Vous pouvez louer un serveur privé virtuel ou une machine dédiée à des hébergeurs associatifs ou commerciaux.

Avantages : votre serveur sera rapide et la connectivité internet sera bonne ;
Inconvénients : il vous faudra payer des frais mensuels pour la machine, et vous n'aurez pas de contrôle physique dessus.

Résumé

	À la maison (e.g. carte ARM, vieil ordi)	À la maison derrière un VPN	Sur un serveur distant (VPS ou dédié)
Coût matériel	Autour de 50€ (e.g. un Raspberry Pi)	Aucun
Coût mensuel	Négligeable (electricité)	Autour de 5€ (VPN)	À partir de ~3€ (VPS)
Contrôle physique sur la machine	Oui	Oui	Non
Routage manuel des ports	Oui	Non	Non
Limitations possibles par le FAI	Oui (voir ici)	Contournées par le VPN	Généralement non
CPU	Généralement ~1 GHz	~2 GHz (droplet Digital Ocean)
RAM	Généralement 500 Mo ou 1 Go	En fonction du prix
Connectivité internet	Dépend de la connexion	Généralement bonne

Installer YunoHost VirtualBox WebUI

Sun, 08 Nov 2026 14:23:29 +0100

Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :

VirtualBox

Pré-requis

Un ordinateur x86 avec VirtualBox installé et assez de RAM disponible pour lancer une petite machine virtuelle avec au moins 1024Mo de RAM et 8Go de capacité de stockage ;
Un fournisseur d'accès à Internet correct, de préférence avec une bonne vitesse d’upload ;
Un ordinateur pour lire ce guide, flasher l'image et accéder à votre serveur.

N.B. : Installer YunoHost dans une VirtualBox est généralement destiné à tester la distribution ou pour développer. VirtualBox n'est pas pratique pour faire tourner un 'vrai' serveur sur le long terme car la machine surlaquelle il est installé ne sera sans doute pas allumé 24h/24, et parce que Virtualbox rajoute une couche de complexité supplémentaire pour ce qui est d'exposer la machine sur Internet.

Télécharger l'image YunoHost

Si votre hôte est en 32 bits, faites bien attention à télécharger l'image 32 bits.

Si vous souhaitez vérifier la validité de nos images signées, vous pouvez télécharger notre clé publique.

Virtualbox

64 bits - to discover or for development

Checksum

Signature

Télécharger v.11.0.9

Virtualbox

32 bits - to discover or for development

Checksum

Signature

Télécharger v.11.0.9

Créer une nouvelle machine virtuelle

Ce n'est pas grave si seulement la version 32-bit est disponible, mais dans ce cas soyez sûr d'avoir téléchargé l'image 32 bit précédemment.

Modifier la configuration réseau

Cette étape est importante pour exposer proprement la machine virtuelle sur le réseau.

Allez dans Réglages > Réseau :

Sélectionnez
```
Accès par pont
```
Choisissez votre interface selon son nom : wlan0 si vous êtes connecté sans-fil, eth0 ou eno1 sinon.

Lancer la machine virtuelle

Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.

Si vous rencontrez l'erreur "VT-x is not available", il vous faut probablement activer (enable) la virtualisation dans les options du BIOS de votre ordinateur.

Lancer l’installation graphique

Votre écran devrait ressembler à la capture ci-dessous :

Capture d'écran du menu de l'ISO

N.B. : A partir du moment où vous aurez validé l'agencement du clavier, l'installation sera lancée et effacera totalement les données sur votre disque dur !

Sélectionnez
```
Graphical install
```
Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone.
L'installateur va ensuite télécharger les paquets requis et les installer.

Lancer la configuration initiale

192.168.x.y

, et vous devriez taper

https://192.168.x.y

Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en .nohost.me / .noho.st / .ynh.fr (exemple :
```
homersimpson.nohost.me
```
). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contrôle complet sur votre configuration DNS.
Si en revanche vous avez déjà votre propre nom de domaine, vous souhaitez probablement l'utiliser. Vous aurez donc besoin ensuite de configurer les enregistrements DNS comme expliqué ici.

yolo.test

et modifier votre fichier

/etc/hosts

root@votredomaine.tld

admin@votredomaine.tld

admin

, qui est peut être toujours mentionné dans certaines pages de documentation. Dans ce cas, remplacez simplement

admin

par votre identifiant.

Lancer le diagnostic

Une fois la postinstall terminée, vous devriez pouvoir vous connecter à la webadmin en utilisant les identiants du premier compte utilisateur que vous venez de créer.

Rappel : YunoHost dans VirtualBox ne sera sans doute pas accessible depuis l'extérieur sans une configuration supplémentaire dans les paramètres de Virtualbox. Le diagnostique se plaindra sans doute de cela.

Le système de diagnostic est conçu pour fournir un moyen facile de valider que tous les aspects critiques de votre serveur sont proprement configurés et pour vous guider dans la résolution des problèmes soulevés. Le diagnostic se lance deux fois par jour et envoie une alerte si un dysfonctionnement est détecté.

N.B. : ne partez pas en courant ! La première fois que vous lancerez le diagnostic, il est assez normal d'avoir plusieurs alertes rouges ou jaunes car vous devez généralement configurer les enregistrements DNS (si vous n'utilisez pas un domaine

.nohost.me

.noho.st

.ynh.fr

Obtenir un certificat Let's Encrypt

Félicitations !

Installer YunoHost VirtualBox ligne de commande

Sun, 08 Nov 2026 14:23:29 +0100

Pré-requis

Un ordinateur x86 avec VirtualBox installé et assez de RAM disponible pour lancer une petite machine virtuelle avec au moins 1024Mo de RAM et 8Go de capacité de stockage ;
Un fournisseur d'accès à Internet correct, de préférence avec une bonne vitesse d’upload ;
Un ordinateur pour lire ce guide, flasher l'image et accéder à votre serveur.

Télécharger l'image YunoHost

Si votre hôte est en 32 bits, faites bien attention à télécharger l'image 32 bits.

Si vous souhaitez vérifier la validité de nos images signées, vous pouvez télécharger notre clé publique.

Virtualbox

64 bits - to discover or for development

Checksum

Signature

Télécharger v.11.0.9

Virtualbox

32 bits - to discover or for development

Checksum

Signature

Télécharger v.11.0.9

Créer une nouvelle machine virtuelle

Ce n'est pas grave si seulement la version 32-bit est disponible, mais dans ce cas soyez sûr d'avoir téléchargé l'image 32 bit précédemment.

Modifier la configuration réseau

Cette étape est importante pour exposer proprement la machine virtuelle sur le réseau.

Allez dans Réglages > Réseau :

Sélectionnez
```
Accès par pont
```
Choisissez votre interface selon son nom : wlan0 si vous êtes connecté sans-fil, eth0 ou eno1 sinon.

Lancer la machine virtuelle

Lancer l’installation graphique

Sélectionnez
```
Graphical install
```
Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone.
L'installateur va ensuite télécharger les paquets requis et les installer.

Lancer la configuration initiale

yunohost tools postinstall

directement sur le serveur ou via SSH.

Capture d'écran de la configuration initiale en ligne de commande

Domaine principal

C’est le nom de domaine qui permettra l’accès à votre serveur ainsi qu’au portail d’authentification des utilisateurs. Vous pourrez ensuite ajouter d'autres domaines, et changer celui qui sera le domaine principal si besoin.

Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en .nohost.me / .noho.st / .ynh.fr (exemple :
```
homersimpson.nohost.me
```
). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contrôle complet sur votre configuration DNS.
Si en revanche vous avez déjà votre propre nom de domaine, vous souhaitez probablement l'utiliser. Vous aurez donc besoin ensuite de configurer les enregistrements DNS comme expliqué ici.

yolo.test

et modifier votre fichier

/etc/hosts

root@votredomaine.tld

admin@votredomaine.tld

admin

, qui est peut être toujours mentionné dans certaines pages de documentation. Dans ce cas, remplacez simplement

admin

par votre identifiant.

Lancer le diagnostic

.nohost.me

.noho.st

.ynh.fr

Code TEXT :

yunohost diagnosis run
yunohost diagnosis show --issues --human-readable

Obtenir un certificat Let's Encrypt

Code TEXT :

yunohost domain cert install