shitan198u/immich-mount-check

Immich Mount Check is a small Docker Compose utility that stops your Immich media server stack from starting if an external hard drive is not actually plugged in and mounted. It is built for people who store their photo library on a separate hard drive from their operating system. The problem it solves is a quirk of Docker bind mounts: if the folder where your drive should be mounted is missing because the drive is unplugged, Docker just creates an empty folder on your main system drive and starts the containers anyway. That means your photos and database can start writing to the wrong disk, which can fill up your main drive or corrupt your database once the real drive is reconnected later. To fix this, the tool adds a Docker Compose override file with a small Alpine Linux helper container that checks the Linux kernel's mount table in a loop to confirm the external drive is really mounted, rather than just checking if a folder has files in it. The main Immich services, including the database, Redis, and the machine learning and server components, are all set to wait until this helper container reports healthy before they are allowed to start. If the drive is not mounted, they stay paused instead of running against the wrong location. Setup involves copying an example environment file, filling in the paths where your drive mounts and where your Immich data should live, then running the stack as usual with Docker Compose. If you do not use a separate external drive, you can leave the mount check settings blank. The project works alongside GitOps workflows and Docker managers like Portainer or Arcane, and it is released under the MIT license.