Creating a Shared Photo Library in Immich

If you’re using Immich to manage your photos, you may have discovered that sharing photos between users isn’t as straightforward as you’d like. Many users, particularly couples or families, want a shared folder where both parties can upload photos that are automatically visible to each other, complete with face recognition and smart search capabilities.

Boats in Crosshaven at sunset.

While Immich has shared albums, they don’t quite solve this problem. The photos don’t appear in search and aren’t processed for face recognition or analysis. What we really need is a true shared library where both users have full access to the same photos with all of Immich’s powerful features.

Here’s a solution using external libraries and symlinks that creates a pseudo-shared folder between Immich users.

The as yet new and unnamed bridge in Cork.

Important: If you rely on uploading photos through the Immich app on your phone this method won’t work for you. You’ll need to sync the photos some other way and copy them into an external library. I export my photos from Lightroom Classic on my laptop, and Syncthing syncs them to the Immich server. Everything is automated from the moment I publish them to the shared directory.

Fisherman's hut in Connemara.

This approach uses external libraries and symbolic links (symlinks) to create a shared photo directory that appears in both users’ Immich libraries. Each user uploads to their own “shared” directory, and through symlinks, those photos automatically appear in the other person’s library as well.

Requirements

  • Access to the Immich server’s file system (typically via SSH or direct access).
  • External libraries enabled for each user.
  • Basic familiarity with Linux commands.

Step-by-Step Setup

Let’s walk through this with an example using John and Mary, a couple who want to share their photos.

1. Set Up External Libraries

First, both users need to have external libraries configured in Immich. For this example, let’s say the external library on the server is this folder:

/mnt/external_library/

It will be mounted in Immich at /external_library/ in this example.

Create a directory structure like this:

/mnt/external_library/
├── john/
│   └── shared/
└── mary/
    └── shared/

2. Configure the External Libraries in Immich

In Immich’s admin web interface:

  • For John, add an external library pointing to /external_library/john
  • For Mary, add an external library pointing to /external_library/mary

3. Create the Symlinks

This is where the magic happens. We’ll create symbolic links that connect each person’s shared directory to the other person’s external library.

Log in to the Immich server and run these commands:

cd /mnt/external_library/john/
ln -s ../mary/shared mary_files
cd ../mary
ln -s ../john/shared john_files

4. Upload and Scan

Now when John uploads photos to /mnt/external_library/john/shared/, they will:

  • Appear in his own Immich library
  • Automatically appear in Mary’s library (via the symlink at /mnt/external_library/mary/john_files)

The same works in reverse for Mary’s uploads.

After uploading, trigger a scan of the external libraries in Immich, and both users will see the shared photos.

A red deer digs up grass during the rutting in Killarney.

How It Works

A symbolic link is like a shortcut that points to another location in the filesystem. When Mary’s Immich library scans /external_library/mary/, it finds the john_files symlink and follows it to John’s actual shared directory. From Immich’s perspective, it looks like Mary has those photos in her library, but they’re actually stored in John’s directory.

Advantages

  • Full Immich functionality: Both users get face recognition, smart search, and all other Immich features on the shared photos
  • Simple uploads: Just upload to your own shared directory—no manual copying needed
  • Bidirectional sharing: Both users can add photos that the other will see
  • Single source of truth: Each photo is stored once (by the person who uploaded it)

Disadvantages

  • Duplicate processing: Immich will process each shared photo twice—once for each user. This means:
    • Face recognition runs twice.
    • Smart search/ML classification runs twice.
    • More CPU and storage usage for thumbnails and metadata.
  • File ownership: Photos remain in the uploader’s directory. If John deletes his Immich library or account, Mary loses access to his photos.
  • Requires server access: You need command-line access to the server to set up symlinks.

Important Notes

  • Upload directly to external libraries: Don’t upload to your main Immich library through the app. Upload directly to the shared directory in your external library.
  • Backup strategy: Make sure your backup solution covers the external library directories.
  • Permissions: Ensure that the Immich container has proper read permissions for all directories involved.
A man in a black coat and cap looks to the side in front of a "SALE" sign with people on the sign.
A young girl sits on the wall nearby.

Conclusion

While this solution requires some technical setup and comes with the overhead of duplicate processing, it provides a practical way to share photos between Immich users with full functionality. This approach has proven reliable for my wife and me, who wanted a shared family photo library without waiting for native multi-user library support in Immich.

If you’re comfortable with the command line and the tradeoff of duplicate processing, this solution provides the shared photo experience many users are looking for.

Playing around with Immich again

Immich Logo

Immich is a self-hosted Google Photos. That’s the simplest way to describe it. It can run in a Docker container and will happily live on your local network, without access to the Internet unless you want to. They do warn you that, “The project is under very active development”, so bugfixes are happening all the time. At the same time, bugs are sometimes introduced, and breaking changes are sign posted weeks in advance.

Immich. How do you pronounce it? I say it with a hard “CH” at the end, but others will say it sounds more like “image”, which leads me to think that’s probably the way to pronounce it.

It looks uncannily like Google Photos. It doesn’t have all the bells and whistles of it’s older, proprietary inspiration, but it does have some very useful features.

I love the face and object recognition in Immich. I can search by people on the Explore page, and search for objects too. It doesn’t present animals on the Explore page, but searching for “chihuahua” leads me to lots of photos of Diego. It’s face recognition that doesn’t go to feeding a gigantic corporation too. It works pretty well, but make sure your Docker install has enough RAM, or it will silently fail.

A screenshot of the Immich mobile app showing a search for chihuahua and thumbnails of my dog.

It has partner sharing too, which is of course a handy feature for families. I noticed that partner shared photos can’t be discovered through the Explore page, where you find face recognition and places. There’s a GitHub issue about this, so it’s something they’re aware of. To be fair, Google Photos has the same limitation (I think) unless you’ve copied the photos to your account, using your precious free space.

To get around this limitation, I symlink any shared photos to my wife’s account. I use External Libraries for 99% of my photos, and 100% of the photos that come from Adobe Lightroom. I export photos to “single” or “shared” directories, and a shell script moves them all to my Immich External Library, and symlinks the shared photos to my wife’s one. On the External Libraries admin page, I simply “Scan new library files” to import the symlinked files. Immich is smart enough to pick up the new files in my External Library. Files are scanned twice, with thumbnails made twice, and face recognition done twice, but the overhead in space used isn’t too bad.

The Quick Start docs tell you to use Docker to install, and if you are at all familiar with Docker, this should be easy enough to follow.

When you do get Immich installed, make sure you perform backups. I have all the images stored elsewhere, but I back up the database file with the docker command listed on that page. Syncthing copies it to another machine, where it’s backed up daily.

Another option is the Nextcloud Memories app which is very slick and looks great. It has face and object recognition too, but it depends on another Nextcloud app to do those jobs. It doesn’t have partner sharing, however, which is the main reason I tried out Immich.

If you do decide to expose your Immich install to the Internet, take a look at Cosmos Cloud. There are other options too, like Caddy or Nginx Proxy Manager. Getting an HTTPS certificate has never been easier. If you don’t know your IP, have a look at https://checkip.amazonaws.com too.