7.4 - Commandes d'administration et récupération

L'image immich-server contient la commande immich-admin.

Lancer la commande

Docker Compose :

docker exec -it immich_server immich-admin help

TrueNAS :

sudo docker exec -it NOM_CONTENEUR_IMMICH immich-admin help

Commandes utiles

immich-admin version
immich-admin schema-check
immich-admin list-users
immich-admin reset-admin-password
immich-admin enable-password-login
immich-admin disable-password-login
immich-admin enable-oauth-login
immich-admin disable-oauth-login
immich-admin enable-maintenance-mode
immich-admin disable-maintenance-mode
immich-admin grant-admin
immich-admin revoke-admin

Récupération d'un accès administrateur

docker exec -it immich_server immich-admin reset-admin-password

Choisir d'invalider les sessions existantes si le mot de passe a pu être compromis.

Si OIDC bloque la connexion :

docker exec -it immich_server immich-admin enable-password-login
docker exec -it immich_server immich-admin disable-oauth-login

Mode maintenance

docker exec -it immich_server immich-admin enable-maintenance-mode

La commande affiche une URL temporaire d'accès maintenance. La protéger comme un secret.

Changement de chemin média

Les versions récentes proposent :

immich-admin change-media-location

Cette commande modifie les chemins stockés en base pour un nouvel emplacement de médias. Elle ne copie aucun fichier. Avant de l'utiliser :

1. sauvegarder la base ;
2. copier et vérifier les médias ;
3. comprendre ancien et nouveau chemin vus par le conteneur ;
4. exécuter en maintenance ;
5. contrôler l'intégrité.

Pour les bibliothèques externes, conserver de préférence le même chemin interne lors d'une migration.

Schéma

docker exec immich_server immich-admin schema-check

Une dérive de schéma doit être analysée avec la version et les journaux. Ne pas modifier manuellement les tables pour faire disparaître le message.

Référence : https://docs.immich.app/administration/server-commands/