Troubleshooting guide
Immich Phone Photos Not Backing Up: Client, Permission, Server
Category: Photo Backup
immich not backing up photos.
Immich upload failures can be on the phone, in the container, or on the TrueNAS dataset. Test one photo through all three layers.
Before you start
- Phone with the Immich app
- Access to the Immich web library
- TrueNAS access for dataset/container status
- One new test photo
Step-by-step checks
Step 1: Confirm the server and account
Open the Immich app settings and record the server URL and signed-in user. Open the same URL in a browser and confirm the library belongs to that user.
Check: The phone and browser show the same server and account.
Step 2: Allow background upload
Grant photo access, background refresh, and mobile data if the test requires it. Disable battery optimization for Immich during the test.
Check: The app's backup screen shows the test album enabled and no permission warning.
Step 3: Check server capacity
Confirm the TrueNAS dataset has free space and the Immich containers are running. Check the server logs for upload or storage errors.
Check: The dataset has free space and no container restart loop.
Step 4: Upload one new photo
Take a new photo, open Immich, and wait for the upload queue to clear. Note the asset's timestamp and album.
Check: The phone queue shows the asset completed.
Step 5: Read it back from the server
Open the photo in the Immich web UI, confirm the date and album, and download a copy. Compare it with the phone original.
Check: The server copy opens and downloads correctly.
Verify the result
A new phone photo appears in the web library, matches the original, and downloads from the server after the phone app is closed.
Rollback
Remove only the test asset if needed. Do not delete the phone original or existing server photos during verification.
Ask for help with this exact symptom · All troubleshooting guides