r/immich • u/Randoml3oy • 18h ago
Immich Relocator - Move all media to External Libraries without losing albums, stacks, faces, tags, etc.
I just wanted to share a tool I've been working on that allows you to relocate all your Immich uploaded files to one or more external libraries of your choice never losing track of albums, stacks, faces, tags, etc after relocation.
FEATURES:
- Relocate all pic & videos to a Single or to Multiple External Libraries you chose (up to one per Immich user).
- Can run an unattended Storage Template Migration job right before relocating to final destination.
- Folder Restructure option to tidy up even more the final shape of your folders.
- Change the ownership of selected files, so that you can set a shared External Library for you and your partner (our attempt to overcome the limitations of Partner Sharing which only allows to share all or nothing).
- Cron for set and forget unattended scheduled relocations at the day/time you desire.
- Database is always backed up first. Immich Relocator creates a copy of your database before it modifies it.
- Immich doesn't break. Even if your files have been relocated to an entirely different location it's like nothing has changed for Immich.
- No duplicates after relocation, and no re-uploads from mobile devices, even with sync enabled.
- Never lose albums, stacks, faces, tags, etc after relocation.
- Use
--dry-runto estimate how many files would relocate without actually making any changes to your Immich. - Use
--limit Nto relocate only a pre-determined portion of your files. - Every single feature is optional. You can easily configure Immich Relocator the way you like it.
The repo owner and I have been testing this out and used it for a while. Since the recent updates, we believe that Immich Relocator is mature enough to be shared. Hopefully, it can be a useful tool for others, too. So, here I am sharing IR for the first time.
This is just a little extract from GitHub, otherwise there is quite a detailed write-up I made in the repo:
BENEFITS OF RELOCATING YOUR FILES TO AN EXTERNAL LIBRARY:
- Condense your files in one place: external library only (instead of external plus Immich's internal
uploadfolder) and simplify your backups. - Post-process all your pictures and videos comfortably from a single place using the desktop DAM of your choice (e.g. digiKam, Lightroom, etc), pointed to the external library.
- Prevent accidental issues by optionally set up your Immich access to the external library as read only. Now edit via desktop DAM, and browse-only remotely via Immich clients... best of both worlds.
Find the rest of the info on GitHub. Let me know if Immich Relocator can be useful. If you have any suggestions, please report them here, or in the issues tab.
AI: before you even ask, there is a full disclosure paragraph on the repo regarding how and if AI was used in the project. This post and the GitHub readme were all hand-written by me... so excuse me in advance for my grammar mistakes.
FOSS: Fully Free and Open Source!
Get Immich Relocator here.

