• Résultat : un Pi disponible en continu pour vos dossiers partagés.
• Sécurité : appareils identifiés par clés cryptographiques ; pas de port d’administration exposé.
• Durée : 30 minutes environ, hors première copie.

Verdict rapide

Syncthing convient aux documents et photos entre appareils personnels. Ce n’est pas une sauvegarde : une suppression se synchronise aussi. Conservez une copie versionnée séparée.

Prérequis

Mettez d’abord le système à jour :

sudo apt update && sudo apt full-upgrade -y

1. Installer Syncthing

Le dépôt de Raspberry Pi OS fournit le paquet :

sudo apt install -y syncthing
syncthing --version

Créez ensuite un emplacement explicite pour vos données. Sur un SSD monté, adaptez le chemin :

mkdir -p ~/Syncthing/Partage
ls -ld ~/Syncthing/Partage

2. Lancer le service avec le bon utilisateur

Syncthing doit tourner avec l’utilisateur propriétaire des fichiers. La commande ci-dessous active le démarrage automatique :

sudo systemctl enable --now syncthing@$USER.service
systemctl status syncthing@$USER.service --no-pager

Le résultat attendu est active (running). Si ce n’est pas le cas, consultez les dernières lignes :

journalctl -u syncthing@$USER.service -n 50 --no-pager

3. Ouvrir l’interface en tunnel SSH

L’interface écoute localement sur le port 8384. Depuis votre ordinateur, créez un tunnel (remplacez les valeurs) :

ssh -L 8384:127.0.0.1:8384 utilisateur@IP_DU_PI

Ouvrez http://localhost:8384. Dans Actions → Settings → GUI, définissez un identifiant et un mot de passe. Ne redirigez pas le port 8384 sur la box ; pour l’administration hors domicile, utilisez SSH ou un VPN.

4. Ajouter un appareil et partager un dossier

1. Installez Syncthing sur le PC ou mobile depuis le site officiel.
2. Sur le Pi, cliquez sur Add Remote Device et saisissez l’identifiant de l’autre appareil.
3. Acceptez l’invitation sur le second appareil, puis donnez-lui un nom reconnaissable.
4. Dans Add Folder, sélectionnez ~/Syncthing/Partage et cochez cet appareil.
5. Acceptez le dossier côté client et choisissez le dossier local de destination.

Cette vidéo d’introduction montre le fonctionnement pair-à-pair :

5. Tester avant de déplacer vos données

Créez un fichier de test sur le Pi :

date > ~/Syncthing/Partage/test-syncthing.txt
ls -l ~/Syncthing/Partage/test-syncthing.txt

Le fichier doit apparaître sur l’autre appareil et l’interface doit indiquer Up to Date. Testez aussi une création depuis le PC : ce double contrôle valide les droits et la liaison.

Dépannage et limites

• Interface inaccessible : vérifiez le tunnel et systemctl status syncthing@$USER.service.
• Dossier bloqué : contrôlez le propriétaire avec ls -ld. Le compte du service doit écrire dans le dossier.
• Appareil déconnecté : vérifiez qu’il est en ligne et que son horloge est correcte.
• Conflit : Syncthing crée un fichier de conflit plutôt que d’écraser silencieusement ; comparez-le avant suppression.

Pour une sauvegarde réelle, associez cette synchronisation à Restic ou Kopia. Docker est une variante pratique si vous gérez déjà des conteneurs, mais l’installation native reste la plus directe pour débuter.

Questions fréquentes

Syncthing remplace-t-il une sauvegarde ?

Non : les suppressions et erreurs sont synchronisées. Gardez une sauvegarde séparée, idéalement versionnée.

Le Pi doit-il rester allumé ?

Non, mais il ne synchronise que lorsqu’il est en ligne. Un Pi permanent rend les fichiers plus disponibles.

Peut-on l’utiliser à distance ?

Oui. Pour administrer le Pi, préférez un tunnel SSH ou un VPN plutôt qu’une interface ouverte sur Internet.

Sources officielles

• Documentation Syncthing
• Démarrage automatique
• Accès distant Raspberry Pi

Vincent Vandegans accompagne les lecteurs de Raspberry Pi France dans leurs projets Linux, réseau, domotique et serveurs maison.

L’article Installer Syncthing sur Raspberry Pi : synchroniser ses fichiers sans cloud, pas à pas est apparu en premier sur Raspberry Pi France.

En bref : ce que vous allez obtenir

• Un serveur SFTP chiffré sur votre Raspberry Pi, accessible sur le LAN.
• Une interface web pour créer des utilisateurs et limiter leur dossier.
• Des données persistantes : une mise à jour du conteneur ne supprime pas la configuration.

Résultat attendu : après environ vingt minutes, un client SFTP se connecte à sftp://IP_DU_PI:2022 avec un compte créé dans SFTPGo.

À qui s’adresse SFTPGo ?

SFTPGo convient pour partager un espace de dépôt avec la famille, transférer les exports d’une caméra ou donner un accès limité à un prestataire. Ce n’est pas un NAS complet : pour la synchronisation continue, regardez Syncthing ; pour des partages visibles dans l’explorateur de fichiers, Samba reste plus naturel.

Prérequis et choix de stockage

• Un Raspberry Pi 4, Pi 5 ou un modèle compatible 64 bits, avec Raspberry Pi OS à jour.
• Un accès SSH et une adresse IP locale connue.
• Docker Engine et le plugin Compose.
• Un SSD USB ou NVMe est conseillé pour des transferts fréquents.

1. Installer Docker et préparer le dossier

Si Docker est déjà présent, passez directement à la création du projet. Vérifiez d’abord que Compose répond :

docker --version
docker compose version

Sur Raspberry Pi OS, la méthode recommandée est celle de la documentation Docker. Créez ensuite un dossier dédié :

mkdir -p ~/sftpgo
cd ~/sftpgo
mkdir -p data

2. Créer le fichier Docker Compose

Ouvrez compose.yml avec nano compose.yml, puis collez cette configuration. Le port 8080 sert uniquement à l’administration web ; 2022 est le port SFTP exposé aux clients.

services:
  sftpgo:
    image: drakkan/sftpgo:latest
    container_name: sftpgo
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "2022:2022"
    volumes:
      - ./data:/var/lib/sftpgo

Enregistrez avec Ctrl+O, validez puis quittez avec Ctrl+X. Démarrez le service :

docker compose up -d
docker compose ps

3. Créer l’administrateur et un premier utilisateur

Dans un navigateur du réseau local, ouvrez http://IP_DU_PI:8080. À la première ouverture, créez le compte administrateur. Dans Users, ajoutez ensuite un utilisateur de transfert :

• choisissez un identifiant sans espace ;
• définissez un mot de passe long et unique, ou une clé publique SSH ;
• donnez-lui un dossier de départ dédié, par exemple /srv/sftp/partage ;
• n’accordez que les permissions nécessaires (lecture, écriture, suppression).

Ne réutilisez pas le compte administrateur pour les transferts quotidiens : un compte par usage rend les révocations et les journaux bien plus simples.

4. Tester depuis Windows, macOS ou Linux

Dans WinSCP ou FileZilla, sélectionnez le protocole SFTP, l’hôte IP_DU_PI, le port 2022, puis les identifiants du nouvel utilisateur. En terminal :

sftp -P 2022 mon_utilisateur@192.168.1.50
put test.txt
ls
exit

La commande put doit téléverser le fichier et ls doit l’afficher. Vérifiez aussi son arrivée dans le dossier configuré sur le Pi.

Une démonstration vidéo utile

Sécuriser l’installation avant un accès hors de chez vous

Pour un usage domestique, gardez d’abord SFTPGo sur le réseau local. Si un accès distant est nécessaire, privilégiez un VPN comme Tailscale ou WireGuard. Évitez d’ouvrir l’interface 8080 sur Internet. Si vous ouvrez le port SFTP, utilisez des clés SSH, désactivez les comptes inutilisés, mettez à jour l’image et consultez les logs :

cd ~/sftpgo
docker compose pull
docker compose up -d
docker compose logs --tail=100 sftpgo

Dépannage : les erreurs les plus courantes

• Connexion refusée : confirmez l’IP, le port 2022 et l’état du conteneur avec docker compose ps.
• Interface inaccessible : testez http://IP_DU_PI:8080 depuis le LAN et vérifiez qu’un pare-feu ne bloque pas 8080.
• Permission denied : contrôlez le dossier de départ et les droits du compte dans SFTPGo, pas seulement ceux du système.
• Données disparues après recréation : assurez-vous que le volume ./data:/var/lib/sftpgo est bien présent et que vous relancez Compose depuis ~/sftpgo.

Variantes et limites

SFTPGo peut aussi utiliser des stockages distants et d’autres protocoles selon votre besoin. Pour un unique accès SSH personnel, le serveur OpenSSH déjà présent sur Raspberry Pi OS est plus léger. Pour des sauvegardes automatisées, associez plutôt Restic ou Kopia à un stockage dédié : SFTPGo est excellent pour l’échange de fichiers, pas pour remplacer une stratégie de sauvegarde.

Questions fréquentes

SFTPGo est-il gratuit ?

Le projet SFTPGo est open source. Vérifiez sa documentation officielle pour les options et évolutions de licence.

Quel port utiliser pour SFTPGo ?

Dans cette configuration, l’administration est sur 8080 et le service SFTP sur 2022. Vous pouvez les changer, à condition d’adapter Compose et votre client.

Puis-je utiliser le port 22 ?

Oui, mais évitez un conflit avec le SSH du Raspberry Pi. Le port 2022 simplifie la coexistence avec OpenSSH.

Sources et documentation

• Documentation officielle SFTPGo
• Dépôt GitHub de SFTPGo
• Installation officielle de Docker Engine

Vincent Vandegans partage des guides concrets pour installer, comprendre et dépanner les outils Raspberry Pi, Linux et maison connectée.

L’article Installer SFTPGo sur Raspberry Pi avec Docker : créer un serveur SFTP sécurisé est apparu en premier sur Raspberry Pi France.

• Hors ligne : le contenu vit sur votre disque.
• Reproductible : Docker démarre Kiwix-serve.
• Local : aucun port Internet n’est requis.

Résultat : ouvrez http://IP_DU_PI:8080 depuis un appareil de votre réseau.

Pour qui ?

Ce guide convient à un atelier maker, une classe, une résidence secondaire ou un foyer qui souhaite garder des ressources consultables sans Internet. Les collections avec images sont volumineuses : un SSD USB est vivement conseillé.

Prérequis

• Raspberry Pi OS 64 bits connecté au réseau ;
• Docker Engine et le plugin Compose ;
• un SSD ou une clé USB avec suffisamment d’espace ;
• l’adresse du Pi, obtenue avec hostname -I.

Étape 1 — Télécharger une collection ZIM

Créez le dossier persistant puis choisissez une collection dans le catalogue officiel Kiwix. Téléchargez le fichier .zim dans ce dossier.

mkdir -p ~/kiwix/data
cd ~/kiwix/data
ls -lh

Contrôlez que le fichier garde bien son extension .zim.

Étape 2 — Créer le service Kiwix

Dans ~/kiwix, créez compose.yml :

services:
  kiwix:
    image: kiwix/kiwix-serve:latest
    container_name: kiwix
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data:ro
    command: "*.zim"

Le montage en lecture seule protège vos fichiers. Lancez et inspectez le service :

cd ~/kiwix
docker compose up -d
docker compose ps
docker compose logs --tail=30 kiwix

Étape 3 — Vérifier l’accès

Ouvrez http://IP_DU_PI:8080 depuis le même réseau. Recherchez un article, puis vérifiez le serveur depuis le Pi :

curl -I http://localhost:8080
docker compose ps

Un conteneur running et une réponse HTTP locale valident l’installation.

Dépannage

Limites et variantes

N’exposez pas le port 8080 sur votre routeur. Pour l’accès distant, utilisez un VPN maîtrisé. Pour actualiser le contenu, remplacez le ZIM puis recréez le service. L’outillage Kiwix natif est une alternative ; Docker reste la méthode la plus simple à reproduire.

Questions fréquentes

Kiwix fonctionne-t-il vraiment sans Internet ?

Oui, après téléchargement du fichier ZIM, la consultation est entièrement locale.

Peut-on installer plusieurs collections ?

Oui : placez plusieurs fichiers ZIM dans le dossier partagé, en surveillant l’espace disque.

Quelle taille de disque choisir ?

Consultez la taille annoncée dans le catalogue avant téléchargement ; un SSD est préférable pour les collections riches.

Sources officielles

• Kiwix
• Kiwix Library
• Kiwix Tools
• Docker Compose

Vincent Vandegans — Passionné de Raspberry Pi, Linux et projets maker, Vincent partage des guides concrets pour construire un numérique plus autonome à la maison.

L’article Installer Kiwix sur Raspberry Pi : créer une bibliothèque Wikipédia hors ligne avec Docker est apparu en premier sur Raspberry Pi France.

Les trois points clés

• Le Pi reçoit uniquement un flux UDP chiffré.
• Chaque téléphone ou ordinateur a une paire de clés distincte.
• Un handshake récent valide la connexion avant tout autre test.

Résultat et prérequis

À la fin, un client mobile rejoint votre réseau local via le Raspberry Pi. Il faut Raspberry Pi OS récent, un accès administrateur, une IP locale réservée, et une box capable de rediriger UDP 51820. Une connexion derrière CGNAT ne permet pas cette redirection.

1. Installer le paquet

Depuis SSH, mettez le système à jour, installez WireGuard et identifiez l’interface qui sort vers Internet (souvent eth0 ou wlan0).

apt update && apt full-upgrade -y
apt install wireguard -y
ip route get 1.1.1.1

2. Préparer les clés

Générez une clé privée et une clé publique pour le serveur, puis une paire différente pour chaque client. La clé privée ne quitte jamais l’appareil qui la possède.

umask 077
wg genkey | wg pubkey

3. Définir le tunnel

Dans la configuration du serveur, attribuez par exemple 10.6.0.1/24, choisissez UDP 51820 et ajoutez une règle de transfert vers votre interface Internet. Activez le routage IPv4 de façon persistante. Dans la configuration client, utilisez 10.6.0.2/24, la clé publique du serveur, votre nom DNS public et PersistentKeepalive = 25.

[Peer]
PublicKey = CLE_PUBLIQUE_SERVEUR
Endpoint = mon-domaine-ou-ip:51820
AllowedIPs = 10.6.0.0/24, 192.168.1.0/24
PersistentKeepalive = 25

Remplacez 192.168.1.0/24 par votre LAN. Pour envoyer tout le trafic Internet dans le VPN, utilisez 0.0.0.0/0 seulement après avoir validé l’accès local.

4. Démarrer et ouvrir le bon port

Activez le service WireGuard, puis vérifiez son état avec wg show. Dans la box, réservez l’IP du Pi et redirigez UDP 51820 vers cette IP. N’ouvrez pas TCP 51820.

5. Tester depuis l’extérieur

1. Désactivez le Wi-Fi du téléphone.
2. Activez le tunnel sur le réseau mobile.
3. Vérifiez wg show sur le Pi.
4. Testez ping 10.6.0.1, puis une ressource de votre LAN.

Dépannage courant

• Pas de handshake : vérifiez DNS ou IP publique, la redirection UDP et le CGNAT.
• Handshake mais aucun accès : vérifiez le routage IPv4, l’interface Internet et les réseaux autorisés.
• Test concluant seulement au domicile : effectuez le vrai test en données mobiles ; certaines box ne gèrent pas le retour vers leur IP publique.

Vidéo de démonstration

Cette démonstration de Tech With Nich complète les étapes ; adaptez toujours les réseaux et les clés à votre installation.

Variantes et limites

Tailscale est une alternative basée sur WireGuard, très pratique en cas de CGNAT. PiVPN ou wg-easy peuvent accélérer la gestion de plusieurs clients, mais les principes restent les mêmes : clés séparées, routes limitées et tests depuis l’extérieur.

Questions fréquentes

WireGuard ralentit-il le Pi ?

Pour un accès domestique courant, la charge est faible ; le débit dépend surtout de votre upload.

Peut-on ajouter plusieurs appareils ?

Oui, avec une clé et une adresse VPN uniques par appareil.

TCP est-il nécessaire ?

Non, WireGuard utilise UDP.

Sources officielles

• WireGuard : installation
• WireGuard : démarrage rapide
• Raspberry Pi : accès distant

Vincent Vandegans — Passionné de Raspberry Pi, Linux et projets maker, il publie des guides concrets pour monter un serveur maison fiable et compréhensible.

L’article Installer WireGuard sur Raspberry Pi : créer un VPN maison sécurisé, pas à pas est apparu en premier sur Raspberry Pi France.

Les 3 points clés

• Cockpit administre le Linux existant : il ne remplace ni Raspberry Pi OS ni SSH.
• La console s’ouvre en HTTPS sur le port 9090 avec un compte Linux local.
• Pour l’extérieur, utilisez un VPN ; ne publiez pas ce port directement sur Internet.

Résultat attendu

Depuis un ordinateur du même réseau, vous ouvrirez https://IP_DU_PI:9090 et pourrez diagnostiquer les services de votre mini-serveur.

Prérequis

Sauvegardez vos données importantes avant toute manipulation de services.

Étape 1 — Mettre Raspberry Pi OS à jour

Connectez-vous en SSH puis appliquez les mises à jour. Redémarrez manuellement seulement si le système le demande.

sudo apt update
sudo apt full-upgrade -y

Étape 2 — Installer Cockpit

Installez le paquet depuis les dépôts Debian de Raspberry Pi OS. Le socket Cockpit est ensuite disponible pour la console web.

sudo apt install -y cockpit
sudo ss -ltnp | grep 9090

Avec UFW, autorisez le port uniquement depuis votre LAN (adaptez le sous-réseau) :

sudo ufw allow from 192.168.1.0/24 to any port 9090 proto tcp

Étape 3 — Ouvrir Cockpit

1. Repérez l’adresse du Pi : hostname -I.
2. Sur le même réseau, ouvrez https://ADRESSE_IP:9090.
3. Vérifiez l’IP puis acceptez l’avertissement initial du certificat auto-signé.
4. Connectez-vous avec votre compte Linux habituel.

Dans Vue d’ensemble, contrôlez CPU, mémoire et disque. Dans Services, recherchez ssh, docker ou votre application, et lisez son journal avant toute action.

Étape 4 — Afficher les mises à jour

Lorsque le paquet est proposé par votre version, ajoutez la vue PackageKit :

sudo apt install -y cockpit-packagekit

Lisez toujours la liste des paquets avant une mise à niveau importante.

Vidéo de prise en main

Tests de validation

1. sudo ss -ltnp | grep 9090 doit montrer une écoute.
2. La page HTTPS doit afficher la vue d’ensemble après connexion.
3. Comparez l’espace disque affiché avec df -h.
4. Dans Journal, recherchez d’éventuelles erreurs Cockpit répétées.

Dépannage

La page ne répond pas

Vérifiez l’IP, le réseau local, le pare-feu et le port 9090 avec la commande de contrôle ci-dessus.

Avertissement HTTPS

Il est normal avec le certificat auto-signé initial. Vérifiez précisément l’adresse du Pi. Pour l’accès distant, préférez Tailscale ou WireGuard.

Connexion refusée

Utilisez un compte Linux existant. Les actions d’administration demanderont les droits sudo ; n’activez pas root pour contourner cette protection.

Alternatives et variantes

• SSH reste le choix le plus léger.
• Portainer complète Cockpit pour Docker, sans le remplacer.
• Webmin apporte plus de modules ; installez uniquement ceux qui sont utiles.
• VPN : Tailscale ou WireGuard est recommandé hors domicile.

Questions fréquentes

Cockpit fonctionne-t-il sur Raspberry Pi 4 ou 5 ?

Oui, avec Raspberry Pi OS basé sur Debian si le paquet est disponible pour votre version.

Faut-il ouvrir le port 9090 sur Internet ?

Non. Gardez Cockpit sur le réseau local et employez un VPN à distance.

Cockpit remplace-t-il Docker ou Home Assistant ?

Non. Il administre l’hôte Linux et complète leurs interfaces spécialisées.

Sources officielles

• Cockpit Project — exécution
• Cockpit Project — guide
• Documentation Raspberry Pi OS

Vincent Vandegans — Passionné de Raspberry Pi, Linux et projets maker, Vincent partage des guides pratiques pour construire et administrer sa maison connectée.

L’article Installer Cockpit sur Raspberry Pi : administrer son serveur Linux depuis un navigateur est apparu en premier sur Raspberry Pi France.

Les 3 points clés

• Syncthing synchronise les appareils directement et chiffre les échanges.
• Un SSD ou disque USB est préférable à la microSD pour les écritures fréquentes.
• La synchronisation ne remplace pas une sauvegarde : une suppression est propagée.

Résultat attendu

Un fichier placé sur votre ordinateur est automatiquement copié dans /srv/syncthing/partage sur le Pi, puis sur les appareils autorisés. Le Pi peut rester à domicile comme nœud toujours disponible.

Prérequis

1. Préparer le stockage

Connectez-vous en SSH. Créez le dossier ; remplacez vincent par votre utilisateur Linux. Vérifiez aussi que le disque est réellement monté avec df -h /srv.

sudo apt update && sudo apt full-upgrade -y
sudo mkdir -p /srv/syncthing/partage
sudo chown -R vincent:vincent /srv/syncthing

2. Installer et démarrer Syncthing

Installez le paquet puis activez le service utilisateur. Le mode linger le maintient actif après fermeture de la session SSH.

sudo apt install -y syncthing
systemctl --user enable --now syncthing.service
sudo loginctl enable-linger $USER
systemctl --user status syncthing.service --no-pager

Le dernier statut doit afficher active (running). Ouvrez ensuite linterface web Syncthing sur le port local 8384 depuis votre réseau. Ne créez pas de redirection Internet pour cette interface.

3. Sécuriser linterface

Dans Actions → Settings → GUI, définissez un nom dutilisateur et un mot de passe. Gardez ladresse découte limitée au réseau local. Pour administrer le Pi à distance, passez par un VPN personnel comme Tailscale ou WireGuard.

4. Créer le dossier partagé

1. Cliquez sur Add Folder.
2. Utilisez le libellé Partage et le chemin /srv/syncthing/partage.
3. Conservez Send & Receive pour modifier les fichiers depuis chaque appareil.
4. Activez Staggered File Versioning si vous souhaitez retrouver des versions remplacées.
5. Enregistrez : le dossier est créé mais doit encore être partagé.

5. Ajouter un PC ou téléphone

Installez Syncthing sur le second appareil. Dans chaque interface, copiez le Device ID depuis Actions → Show ID. Sur le Pi, cliquez sur Add Remote Device, collez cet identifiant, donnez un nom au poste et acceptez la demande sur lautre appareil. Dans Sharing, cochez Partage, choisissez le dossier local sur le PC puis attendez le statut Up to Date.

6. Test de validation

1. Créez test-syncthing.txt dans le dossier du PC.
2. Sur le Pi, contrôlez sa présence : ls -l /srv/syncthing/partage/test-syncthing.txt.
3. Modifiez le fichier sur le Pi puis confirmez la mise à jour sur le PC.
4. Dans Remote Devices, le poste doit être connecté.

Dépannage courant

Service arrêté ou interface indisponible

Contrôlez systemctl --user status syncthing et lIP avec hostname -I. Vérifiez ensuite un éventuel pare-feu local.

Dossier en attente

Les deux appareils doivent accepter le partage. Contrôlez droits et espace avec namei -l /srv/syncthing/partage puis df -h. Un disque USB non monté peut remplir la microSD par erreur.

Conflit de fichiers

Syncthing génère une copie marquée .sync-conflict-. Comparez les versions avant den supprimer une.

Variantes et limites

• Copie de sécurité : ajoutez une sauvegarde versionnée vers un NAS ou un disque débranché.
• Une direction : utilisez Send Only pour la source et Receive Only pour une copie.
• Photos mobiles : activez lenvoi automatique et surveillez lespace disponible.

Questions fréquentes

Syncthing est-il un NAS ?

Non : il synchronise des dossiers. Un NAS peut les héberger, mais ajoute partage réseau, stockage et sauvegarde.

Fonctionne-t-il sans Internet ?

Oui, sur le même réseau local. Internet est utile seulement entre réseaux différents.

Le Pi doit-il rester allumé ?

Oui pour être un nœud permanent ; les autres appareils peuvent tout de même se synchroniser entre eux.

Sources officielles

• Syncthing : premiers pas
• Syncthing : configuration
• Téléchargements

Vincent Vandegans — Passionné de Raspberry Pi, Linux et projets maker, Vincent partage des guides pratiques pour une informatique plus autonome à la maison.

L’article Installer Syncthing sur Raspberry Pi : synchroniser vos fichiers sans cloud, pas à pas est apparu en premier sur Raspberry Pi France.

Les 3 points clés

• Le Raspberry Pi héberge l’interface et compile les firmwares.
• L’ESP32 lit le capteur sur le Wi-Fi 2,4 GHz.
• Après le premier flash USB, les mises à jour passent en Wi-Fi.

Résultat attendu

ESPHome répond sur http://IP_DU_PI:6052 et deux entités sont détectables dans Home Assistant.

Prérequis

• Raspberry Pi OS 64 bits, Docker et Compose.
• ESP32, câble USB de données et DHT22.
• Wi-Fi 2,4 GHz ; Home Assistant est facultatif.

1. Installer ESPHome avec Docker

En SSH sur le Pi :

mkdir -p ~/esphome/config
cd ~/esphome
nano compose.yml

Créez compose.yml :

services:
  esphome:
    image: ghcr.io/esphome/esphome:stable
    volumes:
      - ./config:/config
    ports:
      - "6052:6052"
    restart: unless-stopped

Démarrez et vérifiez :

docker compose up -d
docker compose ps
docker compose logs --tail=30 esphome

2. Créer l’appareil ESP32

Dans New device, choisissez la carte ESP32. Dans config/secrets.yaml :

wifi_ssid: "VotreWiFi"
wifi_password: "MotDePasseWiFi"

3. Ajouter le DHT22

Ajoutez ce bloc au YAML. GPIO4 est à adapter à votre pinout.

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
logger:
api:
ota:
  - platform: esphome
sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature: {name: "Température bureau"}
    humidity: {name: "Humidité bureau"}
    update_interval: 60s

4. Flasher et valider

Branchez l’ESP32 au Pi. Dans ESPHome, utilisez Install → Plug into this computer. Les logs doivent indiquer WiFi connected. Dans Home Assistant, ouvrez Paramètres → Appareils et services puis ajoutez l’intégration découverte.

Vidéo de prise en main

Checklist de validation

Dépannage

Port 6052 inaccessible

Vérifiez l’IP, le pare-feu et les logs du conteneur.

ESP32 absent du Wi-Fi

Contrôlez SSID, mot de passe et réseau 2,4 GHz ; évitez un Wi-Fi invité isolé.

Valeur nan

Relisez alimentation, modèle et GPIO. Conservez 60 secondes entre deux relevés du DHT22.

Variantes et limites

Un BME280 ajoute la pression via I²C. Sauvegardez ~/esphome/config et versionnez vos YAML avec Git si vous multipliez les appareils.

Questions fréquentes

Home Assistant est-il obligatoire ?

Non : ESPHome fonctionne seul ; Home Assistant apporte la découverte et les tableaux de bord.

Comment mettre ESPHome à jour ?

Utilisez docker compose pull && docker compose up -d.

Sources officielles

• ESPHome — démarrage
• ESPHome — DHT
• Home Assistant — ESPHome

Vincent Vandegans — Passionné de Raspberry Pi, Linux et projets maker, Vincent partage des tutoriels concrets pour une maison connectée locale.

L’article Installer ESPHome sur Raspberry Pi avec Docker : créer un capteur Wi-Fi ESP32 pas à pas est apparu en premier sur Raspberry Pi France.

• Un point d’entrée HTTPS unique pour vos applications maison.
• Certificats Let’s Encrypt et redirection HTTPS dans l’interface.
• Installation reproductible avec Docker Compose.

Résultat attendu : https://app.exemple.fr atteint un service de votre Pi avec un certificat valide. Ce guide vise Raspberry Pi OS 64 bits, Debian ou Ubuntu ARM64.

Verdict rapide : pour qui et pourquoi ?

Un proxy inverse reçoit une requête puis l’envoie au bon service interne. NPM ajoute à Nginx une interface pour créer des Proxy Hosts, gérer les certificats et forcer HTTPS. C’est adapté à Home Assistant, Vaultwarden, une application Docker ou un NAS. Il ne remplace ni les sauvegardes ni l’authentification propre à chaque application.

Prérequis

Pour un usage uniquement local, un DNS local suffit. En revanche, le défi HTTP de Let’s Encrypt requiert que le domaine soit joignable publiquement sur le port 80. Ne redirigez jamais le port d’administration 81 depuis votre box.

1. Vérifier Docker Compose

docker --version
docker compose version

Si une commande échoue, installez Docker depuis la documentation officielle Docker pour Debian. Vérifiez ensuite que votre utilisateur peut exécuter Docker avant la suite.

2. Créer et démarrer la stack

Créez un dossier, ouvrez compose.yml, puis copiez la configuration suivante. Remplacez tous les secrets avant le démarrage.

mkdir -p ~/stacks/nginx-proxy-manager
cd ~/stacks/nginx-proxy-manager
nano compose.yml

services:
  app:
    image: jc21/nginx-proxy-manager:latest
    restart: unless-stopped
    ports: ["80:80", "81:81", "443:443"]
    environment:
      DB_MYSQL_HOST: db
      DB_MYSQL_PORT: 3306
      DB_MYSQL_USER: npm
      DB_MYSQL_PASSWORD: REMPLACER_PAR_UN_SECRET
      DB_MYSQL_NAME: npm
    volumes: ["./data:/data", "./letsencrypt:/etc/letsencrypt"]
  db:
    image: jc21/mariadb-aria:latest
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: REMPLACER_PAR_UN_AUTRE_SECRET
      MYSQL_DATABASE: npm
      MYSQL_USER: npm
      MYSQL_PASSWORD: REMPLACER_PAR_UN_SECRET
    volumes: ["./mysql:/var/lib/mysql"]

docker compose up -d
docker compose ps
docker compose logs --tail=50 app

Au premier lancement, MariaDB peut nécessiter quelques instants. Attendez que les deux conteneurs soient démarrés avant de diagnostiquer l’interface.

3. Protéger l’interface d’administration

Sur le LAN, ouvrez http://IP_DU_PI:81. Les identifiants initiaux indiqués par le projet sont admin@example.com et changeme ; modifiez-les immédiatement. L’interface :81 doit rester limitée au réseau local, par l’absence de redirection de port et, si besoin, une règle pare-feu.

4. Ajouter un premier Proxy Host

1. Ouvrez Hosts → Proxy Hosts → Add Proxy Host.
2. Saisissez, par exemple, app.exemple.fr dans Domain Names.
3. Choisissez http, puis l’IP LAN du Pi et le port de l’application cible. Exemple Home Assistant : 192.168.1.50, port 8123.
4. Activez Block Common Exploits ; activez WebSockets seulement si l’application l’exige.
5. Dans SSL, demandez un certificat Let’s Encrypt, acceptez les conditions et activez Force SSL.

Quand NPM et l’application sont dans des fichiers Compose différents, utilisez l’IP LAN stable ou un réseau Docker externe documenté. N’utilisez pas une IP de conteneur : elle peut changer.

5. Tester puis dépanner

1. Ouvrez le domaine HTTPS depuis un autre appareil du LAN.
2. Contrôlez le nom et la date du certificat dans le navigateur.
3. En cas d’erreur 502, testez d’abord le service cible sur son IP et son port.
4. Consultez les journaux : docker compose logs --tail=100 app.

• Certificat refusé : DNS public, port 80, CGNAT ou port déjà occupé sont les causes habituelles.
• 502 Bad Gateway : protocole, adresse ou port cible erroné.
• Connexion en boucle : consultez la documentation de l’application ; des en-têtes proxy ou WebSockets peuvent être requis.

Vidéo de prise en main

Cette démonstration complète la procédure ; adaptez toujours les ports et secrets à votre réseau.

Variantes, limites et sauvegarde

Pour un accès personnel, Tailscale ou WireGuard évite d’ouvrir des ports publics. Sauvegardez régulièrement data, letsencrypt et mysql. Caddy et Traefik sont des alternatives adaptées si vous préférez une configuration déclarative plutôt qu’une interface graphique.

Questions fréquentes

Faut-il un Raspberry Pi 5 ?

Non : un Pi 4 64 bits suffit généralement pour quelques services domestiques ; privilégiez un stockage fiable et le réseau filaire.

Peut-on l’utiliser sans domaine ?

Oui en local avec un DNS interne, mais Let’s Encrypt ne délivre pas de certificat public pour une adresse IP privée.

Comment mettre à jour ?

Sauvegardez les volumes, puis exécutez docker compose pull && docker compose up -d après lecture des notes de version.

Sources officielles

• Nginx Proxy Manager
• Docker Compose
• Let’s Encrypt

Vincent Vandegans — Passionné de Raspberry Pi, Linux et auto-hébergement, il partage des guides concrets pour monter des services maison plus simples et plus sûrs.

L’article Installer Nginx Proxy Manager sur Raspberry Pi avec Docker : guide HTTPS pas à pas est apparu en premier sur Raspberry Pi France.

Les 3 points clés

• Mosquitto distribue les publications MQTT aux appareils abonnés.
• Un compte dédié protège le broker.
• Deux commandes testent la chaîne avant Home Assistant.

Résultat attendu

Votre Pi écoute MQTT sur le LAN, demande un identifiant et affiche un message de test. C’est une base fiable pour Home Assistant, Zigbee2MQTT, Node-RED et vos objets connectés.

MQTT et Mosquitto : à quoi servent-ils ?

MQTT est un protocole léger organisé en sujets, par exemple maison/salon/temperature. Un capteur publie sa mesure ; Home Assistant s’y abonne. Mosquitto est le broker libre qui fait le lien. Un Pi 3, 4, 5 ou Zero 2 W sous Raspberry Pi OS convient.

Prérequis

Étape 1 — Mettre Raspberry Pi OS à jour

sudo apt update
sudo apt full-upgrade -y

Étape 2 — Installer Mosquitto et les clients de test

sudo apt install -y mosquitto mosquitto-clients
sudo systemctl enable --now mosquitto
systemctl is-active mosquitto

La réponse attendue est active. Sinon : sudo journalctl -u mosquitto -n 50 --no-pager.

Étape 3 — Créer un compte MQTT

Créez l’utilisateur maison avec un mot de passe long. -c crée le fichier : ne l’utilisez plus pour ajouter un autre compte.

sudo mosquitto_passwd -c /etc/mosquitto/passwd maison
sudo chown mosquitto:mosquitto /etc/mosquitto/passwd
sudo chmod 640 /etc/mosquitto/passwd

Étape 4 — Interdire l’anonyme et écouter le LAN

Créez un fichier de configuration séparé :

sudo nano /etc/mosquitto/conf.d/maison.conf

Ajoutez :

listener 1883
allow_anonymous false
password_file /etc/mosquitto/passwd
persistence true
persistence_location /var/lib/mosquitto/

Appliquez puis contrôlez :

sudo systemctl restart mosquitto
sudo systemctl status mosquitto --no-pager

Le port 1883 n’est pas chiffré : gardez-le sur le LAN. Pour l’accès distant, utilisez un VPN plutôt qu’une ouverture de port.

Étape 5 — Tester un message

Dans le premier terminal :

mosquitto_sub -h 127.0.0.1 -u maison -P 'VOTRE_MOT_DE_PASSE' -t 'maison/test' -v

Dans le second :

mosquitto_pub -h 127.0.0.1 -u maison -P 'VOTRE_MOT_DE_PASSE' -t 'maison/test' -m 'Bonjour depuis le Raspberry Pi'

Le premier affiche maison/test Bonjour depuis le Raspberry Pi. Depuis un autre appareil, remplacez 127.0.0.1 par l’IP LAN du Pi.

Vidéo : voir l’installation en pratique

Connecter Home Assistant ou un ESP32

Dans Home Assistant, ajoutez l’intégration MQTT, saisissez l’IP du Pi, le port 1883 et le compte maison. Dans un ESP32, utilisez les mêmes paramètres. Préférez des sujets clairs : maison/cuisine/temperature.

Dépannage

• Connection refused : vérifiez l’IP, le statut et sudo ss -ltnp | grep 1883.
• Not authorized : contrôlez le compte puis réinitialisez avec sudo mosquitto_passwd /etc/mosquitto/passwd maison.
• Client distant muet : testez d’abord en local, puis avec l’IP LAN, jamais l’IP publique.
• Service en échec : lisez journalctl -u mosquitto et vérifiez la configuration ajoutée.

Variantes et limites

Pour isoler les usages, créez un compte par appareil et des ACL. TLS chiffre MQTT mais impose la gestion des certificats. Home Assistant OS propose aussi un module MQTT, pratique si le Pi lui est dédié.

Questions fréquentes

Faut-il un Pi puissant ?

Non. Un Pi 3 ou Zero 2 W suffit généralement pour quelques automatismes.

Dois-je ouvrir MQTT sur Internet ?

Non. Gardez MQTT sur le LAN et passez par un VPN à distance.

Comment vérifier l’activation au démarrage ?

systemctl is-enabled mosquitto doit répondre enabled.

Sources officielles

• Mosquitto — configuration
• Mosquitto — mots de passe
• Home Assistant — MQTT

Vincent Vandegans — Passionné de Raspberry Pi, Linux et projets maker, Vincent partage des guides pratiques pour construire une maison connectée fiable et compréhensible.

L’article Installer Mosquitto MQTT sur Raspberry Pi : le guide sécurisé pour Home Assistant et vos capteurs est apparu en premier sur Raspberry Pi France.

Les 3 points clés

• Gardez la microSD intacte jusqu’au test final.
• Utilisez SD Card Copier dans Raspberry Pi OS Desktop.
• Un boîtier USB–SATA fiable et une alimentation correcte sont essentiels.

Résultat attendu

Le Pi démarre sur SSD/NVMe ; la microSD reste une sauvegarde de secours.

Prérequis

Attention : sauvegardez les fichiers importants et débranchez les autres disques USB : la destination sera effacée.

1 — Identifier les supports

sudo apt update
sudo apt full-upgrade -y
lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINTS

La carte est souvent mmcblk0, le SSD USB sda. Contrôlez la taille avant toute copie.

2 — Copier avec SD Card Copier

1. Ouvrez Accessories → SD Card Copier.
2. Choisissez la microSD dans Copy From Device.
3. Choisissez SSD/NVMe dans Copy To Device.
4. Choisissez une nouvelle UUID si proposée.
5. Attendez la fin de copie sans retirer de support.

3 — Démarrer depuis le SSD

Arrêtez le Pi depuis le menu, retirez la microSD, gardez seulement SSD/NVMe connecté et rallumez. Les Pi 4 et Pi 5 récents démarrent normalement sur USB ou NVMe. Si l’écran reste noir, remettez la carte et consultez la documentation Raspberry Pi sur l’ordre de démarrage.

4 — Vérifier la migration

findmnt /
lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINTS
systemd-analyze

findmnt / doit indiquer une partition SSD/NVMe, et non mmcblk0p2. Testez ensuite sudo apt update.

Vidéo

Dépannage

• SSD absent : testez câble, boîtier et port USB 3 ; lisez dmesg -T | tail -n 30.
• Instabilité : vérifiez l’alimentation.
• Retour sur carte : retirez-la au premier essai.

Alternatives

Pour une installation ancienne, installez Raspberry Pi OS directement avec Raspberry Pi Imager puis restaurez vos données. Une migration ne remplace pas une sauvegarde testée.

Questions fréquentes

Un Pi 5 exige-t-il un HAT pour SSD ?

Non pour USB ; oui pour NVMe PCIe.

Le SSD accélère-t-il le CPU ?

Non : il accélère les accès disque.

Sources officielles

• Documentation Raspberry Pi
• Raspberry Pi Imager

Vincent Vandegans — Fondateur de Raspberry Pi France, Vincent partage des guides concrets pour mieux utiliser Raspberry Pi, Linux et les technologies maker à la maison.

L’article Migrer Raspberry Pi OS d’une microSD vers un SSD ou NVMe : le guide pas à pas est apparu en premier sur Raspberry Pi France.