Troubleshooting guide
Immich Mobile Backup Stops After First Batch: Fix Background Upload Stalls
Category: Photo Backup
You started a backup on your phone, the first batch of photos uploaded, and then the immich mobile app background upload simply stopped, leaving the rest of your library untouched.
Check background upload settings
Open the Immich app on your phone and go to Settings > Backup. Confirm that Background Backup is enabled and that the app has permission to run in the background (on Android, check battery optimization; on iOS, check Background App Refresh). If either is off, the app may upload only while open and stop after the first batch. Also verify that the backup album selection includes the photos you expect.
Inspect the first batch result
In the Immich web UI on your TrueNAS host, open the backup album and note how many assets were uploaded. Then check the phone’s backup status screen: if it shows a last upload time but no progress, the app likely paused due to a background restriction or a network drop. If the server shows fewer assets than the phone reports, check the TrueNAS dataset permissions for the upload user.
Verification test
Disable battery optimization for Immich, keep the app open, and trigger a manual backup of a small new album. Watch the upload count increase beyond the first batch. If it completes, background upload is now working; if it stalls again, note the exact asset where it stops and check server logs for errors at that time.
Rollback and recovery
If changes make things worse, revert the battery optimization setting and restart the Immich app. Your uploaded assets remain safe; you can re-enable backup once the test passes. For deeper diagnosis,
