Aller au contenu
Élise OSÉlise OS

Installer avec Docker Compose

Ce parcours est destiné à une machine qui fait déjà tourner Docker, par exemple un NAS ou un serveur domestique. Il démarre le cœur d’Élise à partir du paquet publié avec chaque version.

Prérequis

Section intitulée « Prérequis »
  • Docker Engine 23 ou plus récent, et Docker Compose v2.24.4 ou plus récent.
  • Linux AMD64 ou ARM64, 8 Go de mémoire conseillés (4 Go au minimum).
  • Les ports 8080 et 8555 libres. Home Assistant utilise le réseau de l’hôte sur le port 8124.

Aucun compte n’est nécessaire : les images sont publiques sur GitHub Container Registry.

Installer

Section intitulée « Installer »
Fenêtre de terminal
# Récupérer la dernière version
VERSION=$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/Elise-OS/EliseOS/releases/latest)")
mkdir -p ~/elise && cd ~/elise
curl -fsSLO https://github.com/Elise-OS/EliseOS/releases/download/$VERSION/elise-runtime-$VERSION.tar.gz
curl -fsSLO https://github.com/Elise-OS/EliseOS/releases/download/$VERSION/elise-runtime-$VERSION.tar.gz.sha256


# Vérifier puis extraire l’archive
sha256sum -c elise-runtime-$VERSION.tar.gz.sha256
tar -xzf elise-runtime-$VERSION.tar.gz


# Configurer
cp .env.example .env
sed -i "s/^MICHEL_VERSION=.*/MICHEL_VERSION=$VERSION/" .env


# Facultatif : détecter la clé Zigbee
bash scripts/detect-zigbee-adapter.sh --write-env .env


# Démarrer
docker compose -p elise -f compose.yaml -f compose.release.yaml up -d

Ouvrez ensuite http://<adresse-du-serveur>:8080. Au premier démarrage, l’assistant local crée le compte administrateur.

Les secrets (PostgreSQL, MQTT, sessions, chiffrement des caméras) sont générés au premier démarrage dans un volume Docker privé. Aucun secret n’est écrit dans .env.

Vérifier

Section intitulée « Vérifier »
Fenêtre de terminal
docker compose -p elise -f compose.yaml -f compose.release.yaml ps
curl -fsS http://127.0.0.1:8080/api/v1/system/health

La santé renvoie "status":"ok" et la version installée.

Mettre à jour

Section intitulée « Mettre à jour »

Répétez l’installation dans le même dossier avec la nouvelle version : les volumes Docker (base, secrets, modèles) sont conservés. Faites d’abord une sauvegarde.

Réglages utiles

Section intitulée « Réglages utiles »

Dans .env :

Variable Rôle
MICHEL_HTTP_PORT Port de l’espace aidant (8080 par défaut)
MICHEL_LOCAL_URL Adresse locale annoncée à l’application mobile
TZ Fuseau horaire
ZIGBEE_ADAPTER_MODE auto, ou manual pour un coordinateur distant ou inhabituel
MICHEL_BACKUP_RECIPIENT Clé publique age pour les sauvegardes chiffrées