ImmichI
Immich6mo ago
sidamon

Immich backup restoration on TrueNAS Scale

Hey everyone, I'm trying to migrate my Immich instance to TrueNAS Scale and running into issues.
Background:

Previously had Immich running on bare Debian with docker-compose (following official guide)
Successfully migrated backups between Debian servers multiple times without issues
Standard process was: stop services, restore postgres dump, update paths in .env, start services - worked perfectly
Have 20,000+ photos (~1TB of data)

Current situation:

Trying to move everything to TrueNAS Scale
TrueNAS uses GUI for container management with custom naming (ix- prefixes, etc)
Can't follow standard Immich backup/restore docs because of TrueNAS's abstraction layer
Attempted to convert to Custom App to get docker-compose access, but running into postgres authentication errors

What I have:

Full backup folder structure (library, upload, thumbs, profile, encoded-video, backups)
Database dump: immich-db-backup-1751335200009.sql.gz
Original .env with all settings

Question:
Has anyone successfully restored an Immich backup on TrueNAS Scale? What's the proper way to:

Handle the different container naming scheme
Restore the postgres database
Point to existing photo library

Should I bypass TrueNAS apps entirely and run vanilla docker-compose, or is there a proper way to do this within TrueNAS's framework?
Any help appreciated! 🙏
Was this page helpful?