Installer et utiliser ESPHome sous Docker avec OMV

Aujourd’hui, on fait un focus sur ESPHome : non seulement comment l’installer, mais surtout comment l’utiliser au quotidien. J’ai reçu pas mal de messages disant « ça marche pas », alors j’ai décidé de faire un point complet.

Installation via OpenMediaVault et Docker

Tout se passe dans l’interface d’OpenMediaVault :

Rendez-vous dans Services > Compose.
Cliquez sur pour ajouter un nouveau docker-compose.
Collez le fichier de configuration que je vous propose

services:
esphome:
container_name: esphome
image: ghcr.io/esphome/esphome:2025.7.4
volumes:
- /docker/config/esphome:/config
- /docker/config/esphome/fonts:/config/fonts
- /etc/localtime:/etc/localtime:ro
restart: always
privileged: true
network_mode: host
environment:
- USERNAME=admin
- PASSWORD=123456esphome:
  name: batterie_r48
  friendly_name: Batterie
  min_version: 2024.6.0

Comme pour mes autres conteneurs (LibreSpeed, OnlyOffice…), on définit un répertoire précis pour stocker la configuration. C’est important pour bien s’y retrouver.

Attention : certaines versions récentes d’ESPHome posent problème avec la gestion de la batterie. L’avantage du Docker, c’est qu’on peut imposer une version précise. Personnellement, je suis resté sur la version du 4 juillet (stable pour mes projets).

Connexion à ESPHome

Une fois le conteneur démarré, il suffit d’accéder à :

(exemple : 192.168.1.45:6052)

Identifiants par défaut :

Utilisateur : admin
Mot de passe : 123456 (à changer bien sûr).

On arrive alors sur le tableau de bord ESPHome, prêt à programmer nos ESP32.

Gestion des polices et configuration

Petite subtilité : si vous utilisez des écrans avec vos ESP32, ESPHome a besoin de polices (.ttf).

Normalement, il en intègre déjà, mais j’ai eu des soucis.
J’ai dû récupérer la police Arial.ttf directement depuis Windows.

Pour l’ajouter dans ESPHome, j’ai installé l’extension File Browser via OMV :

Activer File Browser.
Donner les droits sur le dossier docker.
Se connecter à l’interface et uploader Arial.ttf dans le bon répertoire (/config/fonts).

Attention à bien garder le nom en minuscule (arial.ttf).

Compilation et flash de l’ESP32

Ensuite, rien de compliqué :

Créez un projet (par exemple ESP32 Batterie).
Collez votre code YAML (voir mon exemple dans la vidéo précédente).
Compilez. La première fois, c’est un peu long, mais ensuite ça va beaucoup plus vite.
Branchez l’ESP32 en USB.
Installez le firmware compilé.