Automatic File Migration from Uploads to Permanent Storage

[tcarlsen]

I have searched the existing feature requests, both open and closed, to make sure this is not a duplicate request.

• Yes

The feature

Problem Statement

Immich is an excellent solution for automatic mobile photo backup, but currently, there is no built-in mechanism for organizing and relocating uploaded files to a permanent location.

I consider the upload folder as a temporary backup space, where photos are initially stored before I manually curate and organize them into a long-term photo archive. However, moving files manually breaks metadata associations (albums, people tags, object tags, etc.), since Immich treats moved files as new assets rather than recognizing them as existing ones.

Current issues when manually moving files:

• Immich does not track relocated files → If files are moved manually, Immich treats them as new uploads, losing all metadata, album assignments, and AI-generated tags.
• No automation for file organization → I must manually clean up the upload folder, which can be tedious for large libraries.
• No way to define a custom folder structure → It would be useful to organize files based on date, album, location, or custom rules.

---

Proposed Solution: "Organized Storage Management" Feature

I propose adding a feature that allows users to automatically move uploaded files based on predefined rules while retaining all metadata.

1️⃣ Auto-Move System Based on File Age

• Enable auto-relocation for files older than X days (e.g., move files older than 30 days).
• This process runs periodically in the background and moves files from UPLOAD_LOCATION to a permanent storage location without breaking metadata.

2️⃣ Customizable Folder Structure for Storage

• Users should be able to define an organized folder structure for moved files:
  • By date: /YYYY/MM-DD/IMG_1234.jpg
  • By album name: /Albums/Family Trip/IMG_5678.jpg
  • By location: /Europe/Denmark/Copenhagen/IMG_9012.jpg
  • By a combination of rules: /YYYY/MM-DD/{Album}/{Location}/{Filename}

3️⃣ Retain Metadata When Moving Files

• Immich should track file movements internally to ensure metadata (albums, people tags, AI tags) remains intact after relocation.
• A possible implementation:
  • Track files by unique hash instead of file path.
  • If a file is moved, Immich updates its database with the new path rather than treating it as a new upload.

4️⃣ UI-Controlled "Move Files Now" Option

• Users should be able to manually trigger a file move from Immich’s UI with a "Move to Permanent Storage" button.
• Users select which files/albums to move, and Immich handles the process while maintaining metadata.

---

Why This Would Be a Valuable Addition

✔ Prevents metadata loss when organizing files outside Immich.
✔ Automates storage cleanup, reducing manual effort.
✔ Enables structured file organization with customizable folder naming.
✔ Enhances long-term photo management for users with NAS setups.

---

Im looking forward to hear your feedback on this idea and how best to implement this while maintaining Immich’s simplicity and performance. 🚀

Platform

• Server
• Web
• Mobile

[zackpollard]

Hey, we already have a storage template system as you can see in our documentation. https://immich.app/docs/administration/storage-template/

[tcarlsen]

I appreciate the response, but I believe the core of my request was misunderstood.

Storage Templates only define the folder structure for uploaded files, but they do not handle moving older files to an external, permanent storage location (External Libraries).

The reason I want this feature is that I (and many others) use the upload folder as a temporary backup space, where I can review my photos before they are permanently stored.

Right now, everything uploaded from my phone is instantly placed in Immich’s storage structure, but I don’t want all of my phone’s photos to be part of my long-term archive.

📌 Key problem:
• I often take temporary photos (random screenshots, reminders, etc.) that I don’t want in my long-term storage.
• Instead of manually sorting every image before upload, I prefer to clean up my photos inside Immich before they are moved.
• After X days, the remaining photos should be automatically moved to a permanent storage location (External Libraries), while keeping all metadata (albums, AI tags, etc.).

Storage Templates could be part of this, helping define the structure of the moved files, but the core feature I’m requesting is an automated relocation process based on file age.

Could you please reconsider this with this workflow in mind?

[zackpollard]

To me it sounds like your proposed solution is exactly what we have in the storage template system right now, but with an option to set a delay of 30 days or something configurable? I'm not sure why you want to move to "external libraries" specifically, that's not what they are for, you can just mount the storage template folder to your permanent storage location instead.

[tcarlsen]

Thanks again for your response!

Storage Templates can only be applied within UPLOAD_LOCATION and are hardcoded to UPLOAD_LOCATION/library/{user}.
• That means each user gets their own separate storage, and there is no way to move their files into a shared family album.
• If I wanted to move files to my existing NAS photo structure, Storage Templates would force them into a subfolder under admin, which is not how I want them stored.

This is why I need an actual file moving feature:
✅ The /upload folder acts as a personal backup for my whole family (each person only sees their own photos).
✅ After X days, I want photos to be moved to a shared storage location that all family members (and other apps) can access.
✅ This move needs to be physical (not just organizational) and must preserve all metadata.

Storage Templates do not allow this because:
❌ They only control structure inside the upload folder, not across different storage mounts.
❌ The base path cannot be changed, so all files remain under UPLOAD_LOCATION/library/{user}.
❌ Files cannot be physically moved to an external location after a certain time.

Would it be possible to extend Storage Templates or add a new feature that allows automatic file relocation after X days, while keeping all metadata intact?

- ${UPLOAD_LOCATION}:/usr/src/app/upload     # personal upload/backup folder 
- ${LIBRARY_LOCATION}:/usr/src/app/library      # shared library folder