Troubleshooting guide
Immich TrueNAS Permission Denied: Diagnose the Upload Denial
Category: Photo Backup
Your Immich uploads fail with a permission denied error on TrueNAS, and you want to confirm the dataset permissions are the cause before changing anything.
Check the dataset ownership and mode
Open the TrueNAS shell and run ls -ld /mnt/your-pool/immich. The third and fourth columns are the owner and group; the first column shows the mode. Immich’s container user must match the owner or be in the group, and the mode must allow write. If the owner is root and the mode is 755, a non-root Immich user cannot write. That result confirms the immich truenas permission denied condition.
Check the container user
Run docker exec -it immich_server id (or the equivalent for your app). Note the uid and gid. Compare them with the dataset owner and group from the previous step. If they differ and the group lacks write, uploads will be denied.
Apply the narrow fix
Set the dataset owner to the Immich uid and gid, for example chown -R 1000:1000 /mnt/your-pool/immich, then confirm the mode allows the owner to write. Avoid broad 777 changes; they hide the real mismatch.
Verification test
From the Immich web UI, upload a single small photo. A successful upload with no permission error confirms the fix. Then retry one photo from the phone on the same LAN.
Rollback note
Record the original owner, group, and mode before changing them. If Immich or another app breaks, restore those values with chown and chmod to return to the prior state.
If the checks still point to an unclear ownership mismatch,

Ask for help with the ls -ld and id output.