11 projets Docker géniaux à essayer sur Raspberry Pi

J’entendais souvent parler de Docker sur Raspberry Pi, sans trop comprendre pourquoi tout le monde en parlait autant. Et puis j’ai vu ce que ça permettait de faire… On peut tester plein d’apps dans des conteneurs isolés, sans créer de conflit avec le reste du système. Si vous débutez avec Docker, ces projets sont parfaits pour découvrir ce que cela peut vous apporter.

Pour vous donner une idée, Docker est utilisé sur Raspberry Pi pour exécuter des applications et des services isolés, évitant les conflits avec le système ou d’autres logiciels. Cela simplifie l’installation et la gestion dans plusieurs environnements.

Dans cet article, je vais vous montrer quelques projets Docker géniaux qui sont utiles et faciles à mettre en place. Nous irons droit au but avec des idées concrètes. Si vous débutez avec Docker, ne vous inquiétez pas, le premier projet vous expliquera les bases.

Si vous êtes à la recherche d’inspiration pour votre prochain projet Raspberry Pi, j’ai créé une liste avec plus de 75 idées avec une courte description, le niveau et matériel conseillé, et des liens vers des tutoriels. Que vous soyez débutant ou plus expérimenté, vous trouverez des idées adaptées à votre niveau. Accès gratuit ici !

Gérer les conteneurs facilement avec Portainer

Si vous débutez avec Docker, c’est ici que vous devez commencer. Portainer vous offre une belle interface web pour gérer les conteneurs, volumes, réseaux et images, sans avoir à mémoriser de longues commandes.

Portainer est conçu pour Docker. L’exécuter comme un conteneur signifie que vous gérez Docker… avec un autre Docker, c’est étrange mais efficace. C’est rapide, isolé et c’est le projet parfait pour débuter.

Exigences :

Aucune exigence au-delà des bases, il fonctionne très bien sur n’importe quel Pi 4 ou Pi 5.

Comment l’exécuter :

Après avoir installé Docker, vous pouvez exécuter :
docker run -d -p 9000:9000 --name portainer \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data portainer/portainer-ce

Ensuite, visitez http://<Votre-IP-Pi> et créez votre compte admin.

Si vous souhaitez un guide plus complet (y compris des conseils sur les volumes et les tâches importantes), consultez notre guide complet sur comment installer et utiliser Portainer sur Raspberry Pi (en anglais). C’est un excellent premier pas dans la gestion des conteneurs.

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Bloquer les publicités sur tout le réseau avec Pi-Hole

Vous en avez marre des publicités sur votre TV, téléphone et ordinateur ? Pi Hole agit comme un serveur DNS local qui bloque le contenu indésirable avant même qu’il ne se charge. Une fois configuré, tout ce qui est connecté à votre Wi-Fi bénéficie d’une navigation sans publicité.

Utiliser Pi-Hole dans un conteneur le rend isolé et facile à mettre à jour, sans affecter d’autres services sur votre Pi. De plus, installer Pi-Hole manuellement nécessite des modifications au niveau du système. Avec Docker, c’est propre, rapide et facile à mettre à jour ou à supprimer plus tard.

Exigences :

• Connexion Ethernet sur le même réseau local chez vous.
• Configurer le DNS de votre routeur pour pointer vers le Pi.

Comment l’exécuter :

La meilleure façon d’exécuter Pi-Hole sans trop de tracas est de démarrer un conteneur via Docker Compose. Vous n’aurez qu’à créer un fichier YAML avec ce contenu :

services:
  pihole:
    image: pihole/pihole:latest
    container_name: pihole
    environment:
      - FTLCONF_webserver_api_password=yourpassword
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "80:80"
    volumes:
      - ./etc-pihole/:/etc/pihole/
    restart: unless-stopped

Et ensuite, démarrez-le en utilisant Docker Compose :
sudo docker compose up -d

Cela le fera fonctionner en arrière-plan, mais si vous devez un jour l’arrêter, vous pouvez aussi utiliser :
sudo docker compose down

Si vous êtes curieux, vous pouvez aussi installer et exécuter Pi-Hole en dehors d’un conteneur (en anglais) sur Linux, mais cela dépend entièrement de vos besoins.

Automatiser votre maison avec Home Assistant

Home Assistant vous aide à contrôler des ampoules connectées, des thermostats, des capteurs et plus encore — le tout depuis un seul tableau de bord. Il prend en charge des centaines d’appareils et est incroyablement personnalisable.

Utiliser Docker et des conteneurs est la meilleure option pour exécuter Home Assistant, car il se met à jour souvent. Avec Docker, les mises à jour ne pourront pas casser d’autres parties de votre système.

Exigences supplémentaires :

• Raspberry Pi 4 ou mieux.
• Facultatif : dongles Zigbee/Z-Wave pour appareils domotiques.

Comment l’exécuter :

Avec Docker Compose :

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /opt/homeassistant:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

Si Docker ce n’est pas votre truc, vous pouvez utiliser la méthode traditionnelle, en utilisant seulement Linux. (en anglais)

Exécuter un serveur multimédia (JellyFin / Plex)

Transformez votre Raspberry Pi en votre propre Netflix. Que vous regardiez depuis la TV du salon ou votre téléphone, Jellyfin et Plex vous permettent de diffuser des vidéos, de la musique et des photos depuis votre Pi.

Les serveurs multimédias ont souvent beaucoup de dépendances. Docker conserve tout dans son propre conteneur, ce qui facilite la gestion et la mise à jour, et en plus, cela vous protège, évitant de casser quoi que ce soit.

Exigences :

• Stockage externe ou grande carte SD (pour vos fichiers multimédias).
• Raspberry Pi 4 ou 5 recommandé, Jellyfin bénéficie du décodage matériel.

Comment l’exécuter :

Pour l’installation, vous pouvez simplement utiliser les images officielles sur Docker Hub, ce qui vous permettra de l’exécuter avec les bonnes options :

docker run -d \
  --name jellyfin \
  -v /path/to/config:/config \
  -v /path/to/media:/media \
  -p 8096:8096 \
  jellyfin/jellyfin

Accédez-y depuis http://<Votre-IP-Pi>:8096 pour configurer votre bibliothèque.

Si vous ne savez pas quel serveur multimédia choisir, vous pouvez les essayer sans Docker. Nous avons couvert les deux options en détail : Jellyfin sur Raspberry Pi et configuration du serveur multimédia Plex. Choisissez celui qui correspond à vos besoins et commencez.

Tout surveiller avec Grafana et Prometheus

Suivez les performances de votre Pi, les statistiques réseau, ou plusieurs appareils. Grafana gère les graphiques et tableaux de bord, Prometheus gère la collecte de données et le stockage des séries temporelles. Node Exporter peut suivre l’utilisation du CPU, de la mémoire ou du disque sur différents systèmes.

Avec Docker, vous pouvez déployer Prometheus, Node Exporter et Grafana en même temps, en gardant les services séparés et faciliter leur mise à jour.

Exigences

• Aucune, mais des sources de données externes comme Node Exporter peuvent aider.

Comment installer :

Avec Docker Compose, vous pouvez inclure à la fois Prometheus et Grafana dans un seul fichier Docker Compose pour les déployer tous les deux en même temps :

services:
  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"
    volumes:
      - grafana-storage:/var/lib/grafana

  prometheus:
    image: prom/prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml

volumes:
  grafana-storage:

Il est nécessaire de créer un fichier prometheus.yml avant de démarrer Docker Compose. Vous pouvez le tester avec une configuration minimale à l’intérieur :

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: "prometheus"
    static_configs:
      - targets: ["localhost:9090"]

Pour plonger plus profondément dans les tableaux de bord et les statistiques en temps réel, consultez ce guide complet sur l’installation sur Raspberry Pi avec des conseils supplémentaires sur l’utilisation des exportateurs et le stockage persistant.

Sécuriser vos mots de passe avec Vaultwarden (alternative à Bitwarden)

Vaultwarden est un clone léger de Bitwarden que vous pouvez héberger vous-même. C’est parfait pour garder tous vos identifiants de connexion en sécurité et les synchroniser sur vos appareils.

Le faire fonctionner dans Docker est en fait la méthode la plus recommandée. C’est beaucoup plus facile que de configurer Nginx, des bases de données, des configurations et d’autres paquets nécessaires pour le faire fonctionner.

Exigences :

• Mot de passe admin fort.
• Activer HTTPS pour une sécurité renforcée.

Comment l’exécuter

docker run -d \
  --name vaultwarden \
  -v /vw-data:/data \
  -p 8080:80 \
  vaultwarden/server

Visitez http://<Votre-IP-Pi>:8080 pour utiliser le coffre-fort web.

Si utiliser VaultWarder ne vous attire pas, vous pouvez aussi utiliser la version originale (Bitwarden) et expérimenter avec votre Raspberry Pi.

Configurer un serveur VPN (réseau privé virtuel) avec WireGuard

WireGuard vous permet d’accéder à votre réseau domestique en toute sécurité depuis n’importe où. Vous pouvez naviguer en toute sécurité et de façon chiffrée sur des réseaux Wi-Fi publics ou accéder à votre NAS et aux outils de votre Pi en déplacement.

En utilisant un conteneur, vous pouvez éviter de modifier directement le fichier système, et vous pouvez le déployer sur n’importe quel appareil autant de fois que vous le souhaitez et à tout moment. Pas besoin de s’embêter avec iptables ou la configuration réseau du système à la main.

Exigences :

• Raspberry Pi 4 ou 5.
• Redirection de port sur votre routeur.
• IP statique ou DDNS.

Comment l’exécuter :

Vous pouvez utiliser cette configuration Docker Compose, l’option la plus recommandée pour exécuter WireGuard :

services:
  wireguard:
    image: lscr.io/linuxserver/wireguard
    container_name: wireguard
    cap_add:
      - NET_ADMIN
      - SYS_MODULE
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Your/Timezone
      - SERVERURL=your.ddns.net
      - SERVERPORT=51820
      - PEERS=1
      - PEERDNS=auto
      - INTERNAL_SUBNET=10.13.13.0
    volumes:
      - ./config:/config
      - /lib/modules:/lib/modules
    ports:
      - 51820:51820/udp
    sysctls:
      - net.ipv4.conf.all.src_valid_mark=1
    restart: unless-stopped

Une fois en marche, connectez-vous au conteneur pour voir la configuration générée :
docker exec -it wireguard /app/show-peer 1

Avez-vous encore besoin d’aide avec le réseau ou la redirection de port ? Nous avons un guide complet sur l’installation de WireGuard sur Raspberry Pi, ainsi qu’une version générale d’installation sous Linux (en anglais) pour des configurations avancées.

Exécuter des modèles d’IA localement dans un conteneur (LLM et Whisper)

Il est maintenant possible d’exécuter de petits modèles d’IA sur un Raspberry Pi ! Avec des outils comme Whisper (reconnaissance vocale) et des LLM comme x, vous pouvez expérimenter avec la transcription vocale locale ou des chatbots sans avoir besoin d’accès au cloud.

Docker est parfait pour cela car il isole les environnements Python, les dépendances comme PyTorch, et facilite la configuration. Pas besoin de polluer votre système avec des paquets cassés.

Exigences :

• Raspberry Pi 5 fortement recommandé.
• Refroidissement passif ou dissipateur thermique.
• SSD USB ou grand espace de stockage si vous exécutez des modèles localement.

Comment l’exécuter :

Vous pouvez exécuter des modèles comme Whisper (pour la reconnaissance vocale) ou des LLM légers (comme llama.cpp) en utilisant des images Docker préconstruites. Whisper nécessite un fichier modèle (par exemple, le modèle tiny) qui lui indique comment traiter l’audio.

Tout d’abord, téléchargez le modèle. Vous pouvez le télécharger directement depuis leur site web et le sauvegarder dans votre répertoire actuel.

Ensuite, exécutez Whisper sur votre fichier audio :
docker run --rm \
-v "$PWD/models:/models" \
-v "$PWD:/data" \
ghcr.io/ggerganov/whisper.cpp:main \
./main -m /models/ggml-tiny.bin -f /data/yourfile.wav -otxt

Remplacez yourfile.wav par le nom de votre enregistrement. La transcription de sortie sera sauvegardée dans le même dossier. Vous pouvez aussi utiliser d’autres modèles comme base, small ou medium en téléchargeant le fichier correspondant.

Vous voulez plus d’idées pour l’IA sur le Pi ? Ne manquez pas notre liste de projets d’IA faciles pour Raspberry Pi (en anglais) ou apprenez comment utiliser l’API ChatGPT en Python (en anglais) pour créer votre propre chatbot.

Héberger votre propre serveur de jeu (Minecraft, etc.)

Permettez à vos amis de rejoindre votre propre serveur Minecraft hébergé entièrement sur un Raspberry Pi. Cela fonctionne aussi pour d’autres serveurs de jeux légers comme Minetest. Vous pouvez déployer des serveurs de jeux sans modifier votre OS ou gérer manuellement les installations de Java.

Avec Docker, vous pouvez isoler le serveur de jeu de votre OS, et le redémarrer ou ajuster les paramètres facilement sans casser votre Pi. Pas besoin de gérer les versions de Java ou de s’occuper de longs scripts d’installation.

Exigences :

• Raspberry Pi 4 ou 5.
• Refroidissement recommandé.
• Ethernet câblé pour une meilleure latence.

Comment l’exécuter (Minecraft) :

Une image populaire pour Minecraft est itzg/minecraft-server. Elle gère tout, de la création du monde à la gestion des versions.

Voici comment l’exécuter sur votre Pi :
docker run -d -it \
-p 25565:25565 \
-v minecraft-data:/data \
-e EULA=TRUE \
--name mc-server \
itzg/minecraft-server

Cela lancera un serveur Minecraft Java Edition vanilla. Les joueurs peuvent le rejoindre via l’IP de votre Pi si vous êtes sur le même réseau, ou vous pouvez rediriger le port pour un accès en ligne.

Vous pouvez le personnaliser en utilisant des variables d’environnement (RAM, version, mode de jeu) selon vos besoins.

Vous trouverez tout ce dont vous avez besoin (des sauvegardes de monde, ajustements de serveur…) dans ce guide dédié sur comment exécuter un serveur Minecraft sur Raspberry Pi.

Héberger un serveur web simple ou un backend API

Si vous apprenez le développement web ou construisez vos propres outils, utiliser des outils comme Node.js, Flask ou des serveurs PHP sur votre Pi est la meilleure façon de les déployer. Cela peut être utilisé pour des applications de loisir, des tableaux de bord ou même des API auto-hébergées.

Docker est la meilleure façon d’exécuter ces outils. Au lieu d’installer des outils de développement globalement, Docker vous permet d’exécuter chaque application de façon isolée avec juste un Dockerfile ou un fichier Compose.

Exigences :

• Aucune. N’importe quel Pi avec Docker fera l’affaire. Ajoutez des ressources seulement si votre application en a besoin.

Comment l’exécuter :

Cela dépend vraiment des outils que vous allez utiliser pour le déploiement de votre web ou application. Mais, par exemple, pour Node.js, vous pouvez utiliser :

docker run -d -p 3000:3000 \
  --name nodeapp node:18 node index.js

Si vous avez besoin de plus d’aide pour mettre vos outils web en ligne, consultez nos tutoriels pour configurer un serveur web, installer Nginx (en anglais), ou utiliser Webmin pour gérer votre serveur (en anglais).

Créer un serveur de documents privé

Paperless-ngx vous permet de scanner, stocker, rechercher et organiser des documents dans une interface web élégante. C’est parfait pour gérer des factures ou des papiers à la maison. L’application repose sur PostgreSQL, Redis et des outils OCR.

Comme cela nécessite de faire fonctionner plusieurs services, Docker est le moyen le plus simple et le plus élégant de les exécuter tous ensemble.

Exigences :

• Pi 4 ou Pi 5.
• SSD ou grand disque USB.
• Scanner externe (ou téléphone).

Comment l’exécuter

La façon la plus simple de déployer Paperless-ngx est avec Docker Compose, qui gère PostgreSQL, Redis et l’application principale dans une seule configuration. Voici un docker-compose.yml de base pour commencer :

services:
  broker:
    image: docker.io/library/redis:8
    restart: unless-stopped
    volumes:
      - redisdata:/data
  db:
    image: docker.io/library/postgres:17
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: paperless
  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    depends_on:
      - db
      - broker
    ports:
      - "8000:8000"
    volumes:
      - data:/usr/src/paperless/data
      - media:/usr/src/paperless/media
      - ./export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume
    env_file: docker-compose.env
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
volumes:
  data:
  media:
  pgdata:
  redisdata:

Ensuite, ouvrez votre navigateur et visitez :
http://<Votre-IP-Pi>:8000
Connectez-vous avec les identifiants admin que vous avez définis ci-dessus.

De plus, il est nécessaire d’avoir un docker-compose.env dans votre répertoire actuel pour faire fonctionner ce conteneur. Vous pouvez aussi explorer d’autres options de backend comme mariadb ou sqlite sur leur dépôt github.

Comme vous l’avez vu, Docker ouvre la porte à des projets Raspberry Pi puissants et créatifs, de la domotique aux services cloud personnels, tout en gardant votre système propre et facile à gérer. Une fois que vous êtes à l’aise avec les conteneurs, les possibilités sont infinies.

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