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


Back to the service page · Ask about this exact symptom