IMMICH_MEDIA_LOCATION

[spiral creek]

I've set up Immich using docker compose. I've set the upload location as a share on my Unraid NAS but wasn't sure whether I could actually change the Upload location to a local folder on my Ubuntu Server Virtual Machine with the photos then being added to my NAS share. With this in mind, does anyone know:

1. What the environment variable 'IMMICH_MEDIA_LOCATION' does if added?
2. What NFS folder permissions should the NFS Unraid share be exported as to allow Immich to read and write to this?

Thanks for your help.

[limpid scarab]

:wave: Hey @spiral creek,

Thanks for reaching out to us. Please follow the recommended actions below; this will help us be more effective in our support effort and leave more time for building Immich .

References

• Container Logs: docker compose logs docs
• Container Status: docker compose ps docs
• Reverse Proxy: https://immich.app/docs/administration/reverse-proxy

Checklist

1. :ballot_box_with_check: I have verified I'm on the latest release(note that mobile app releases may take some time).
2. :ballot_box_with_check: I have read applicable release notes.
3. :ballot_box_with_check: I have reviewed the FAQs for known issues.
4. :ballot_box_with_check: I have reviewed Github for known issues.
5. :ballot_box_with_check: I have tried accessing Immich via local ip (without a custom reverse proxy).
6. :ballot_box_with_check: I have uploaded the relevant logs, docker compose, and .env files using the buttons below or the /upload command.
7. :ballot_box_with_check: I have tried an incognito window, disabled extensions, cleared mobile app cache, logged out and back in, different browsers, etc. as applicable

(an item can be marked as "complete" by reacting with the appropriate number)

If this ticket can be closed you can use the /close command, and re-open it later if needed.

[limpid scarab]

Successfully submitted, a tag has been added to inform contributors. :white_check_mark:

[lone briar]

Answer for 1. IMMICH_MEDIA_LOCATION is where the code looks in the container structure for media files. It defaults to ./upload.

No idea, number two

[spiral creek]

Thanks. What would the differerence be then between IMMICH_MEDIA_LOCATION and UPLOAD_LOCATION in a docker compose environment file?

[lone briar]

If I am understanding the docs right. UPLOAD_LOCATION maps to your physical drive outside the container.

So normally would be like /mnt/large_drive/photo_location_for_immich

The IMMICH_MEDIA_LOCATION controls the other side of the docker bind mount. In default compose you see this for the volume:
${UPLOAD_LOCATION}:/usr/src/app/upload

Immich in the container is looking for that path on the right for the media files (/usr/src/app/upload). IMMICH_MEDIA_LOCATION sets the default to read from ./upload. If you change that, you will need to change the right side volume mount to match.

(This is me looking at docs, not a dev)

[spiral creek]

Ahhh right. I probably just need to set UPLOAD_LOCATION as the folder on the NAS and not use the IMMICH_MEDIA_LOCATION variable - thanks for your help.