2.3 - Démarrer et contrôler les conteneurs

Démarrer Immich

Depuis le dossier contenant .env et docker-compose.yml :

cd /srv/immich/app
docker compose pull
docker compose up -d

Contrôler l'état

docker compose ps
docker compose images
docker compose logs --tail=100

Suivre le serveur :

docker compose logs -f immich-server

Quitter le suivi avec Ctrl+C. Cela n'arrête pas le conteneur.

Tester le port

Le déploiement Compose officiel utilise normalement le port 2283 :

ss -ltnp | grep 2283
curl -I http://127.0.0.1:2283

Ouvrir ensuite :

http://ADRESSE_DU_SERVEUR:2283

Examiner un service en erreur

docker compose ps -a
docker compose logs --tail=200 database
docker compose logs --tail=200 immich-server
docker compose logs --tail=200 immich-machine-learning

Le service PostgreSQL peut porter un autre nom dans une ancienne configuration. Utiliser :

docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'

Vérifier les montages

docker inspect immich_server --format '{{range .Mounts}}{{println .Source "->" .Destination}}{{end}}'
docker exec -it immich_server sh -lc 'ls -la /data'

Les dossiers suivants doivent être accessibles :

/data/upload
/data/library
/data/thumbs
/data/profile
/data/encoded-video
/data/backups

Commandes de cycle de vie

docker compose stop
docker compose start
docker compose restart immich-server
docker compose down

docker compose down supprime les conteneurs et réseaux du projet, mais les bind mounts externes restent normalement présents. Ne pas ajouter -v sans avoir vérifié les volumes, car cette option supprime les volumes gérés par Docker.

Après modification de .env

Un simple redémarrage ne remplace pas toujours l'environnement du conteneur :

docker compose up -d

Si nécessaire :

docker compose up -d --force-recreate

Référence : https://docs.immich.app/install/environment-variables/