Immich
Immich is a popular self-hosted photo server. RapidRAW can connect to it, so you can browse your Immich library, open and edit photos as if they were on your disk, and upload finished exports back. Your edits are saved in Immich, so they look the same on every computer you use.
Requires Immich 2.5 or newer. On Android, servers with a Let's Encrypt certificate work since version 1.6.8.
Setting it up
- In Immich, open Account Settings → API Keys and create a new key. Give it at least these permissions:
album.read,album.create,albumAsset.create,albumAsset.delete,asset.read,asset.view,asset.download,asset.upload,asset.update,asset.delete,stack.read,stack.createanduser.read. - In RapidRAW, open Settings → General → Immich.
- Enter the Server address (for example
https://photos.example.com) and the API key. - Click Test connection. You should see "Connected as ..." with your user name and Immich version.
- Click Save.
album.create is only needed to create albums from the Export panel. If your key doesn't have it, everything else still works. To use it, create a new key that includes it.
The API key is stored in your operating system's credential store.
Note On macOS, RapidRAW asks for local network access the first time it connects to a server at home. Click Allow. See Troubleshooting on macOS.
Browsing
An Immich section appears in the Sources panel. It contains:
- Timeline, organized by year and month.
- Albums, a collapsible entry with the number of albums. Click it to open or close the list, so a long album list doesn't push the rest of the sidebar down. RapidRAW remembers whether it is open.
- In no album comes first. It shows every photo that is not in any album yet, so you can see what still needs sorting. A stack counts as sorted as soon as one of its photos is in an album.
- Then your Immich albums, including shared ones (shown with a people icon). They are sorted like your folders: choose the order in the Sources panel's Options menu (☰), for example Alphabetically or Image Count.
- A status line that shows when you are offline, or how many edits are still waiting to be sent.
Only photos are shown, no videos. If several files are stacked in Immich (for example RAW and JPEG), they appear as one photo and RapidRAW opens the RAW.
Thumbnails load from the server. The original file is downloaded the first time you open a photo, and kept in a local cache (20 GB by default, see Settings → Data Management). Photos that are not downloaded yet show a small cloud icon.
Sorting photos into albums
Drag thumbnails onto an Immich album in the Sources panel to add them to it, the same way as with local albums.
- Photos from Immich are added to the album. They stay in their other albums too.
- Photos from a local folder are uploaded to Immich first, together with their edits, and then added to the album. The local files are not changed or removed.
- Drop photos onto In no album to upload local photos without putting them in an album.
A message shows the progress ("Adding to Immich… 3/12") and how many photos were added. Virtual copies can't be uploaded this way, because they are not separate files.
If a local photo is already in Immich and has different edits there, the edits in Immich stay and your local edits are kept as a virtual copy.
Example: after a trip, open In no album, select the beach photos with Ctrl+Click and drag them onto your "Summer 2026" album. Repeat for the other albums until In no album is empty.
Editing and sync
Edit Immich photos exactly like local ones. Your edits, rating, flag and tags are saved into the photo's metadata on the Immich server every few seconds.
- Open the same photo on another computer and you get the same edit.
- If the photo was edited somewhere else in the meantime, your version is kept and the other version is added as a virtual copy, so nothing is lost.
- If you close RapidRAW while edits are still waiting to be sent, it warns you first.
- When the server is unreachable you can keep working. Edits are sent when the connection is back. If the Immich section says "Immich is not reachable.", hover that text to see the reason, for example a certificate or name lookup problem.
- Immich only lets the owner of a photo save edits to it. For photos someone else shared with you, RapidRAW tells you once and keeps your edits on this computer only.
Exporting to Immich
In the Export panel, set Destination to Immich:
| Option | What it does |
|---|---|
| Album | Album the image was opened from (default), No album, New album…, or any of your Immich albums. New album… shows a name field: type a name and click Create. RapidRAW creates the album in Immich and selects it for the export. This needs the album.create permission. |
| Upload the original too | For photos from a local folder: uploads the original together with its edits, and stacks the export on top of it in Immich. Photos that come from Immich are always stacked on their original. |
Earlier exports stay in the stack, so you can find older versions too. If you exported a JPEG and it is stacked under its export, opening the stack opens the original JPEG, so you can keep editing it.
Exports of photos that someone else shared with you are uploaded and added to the album, but not stacked on the original.
Copying, moving and deleting
- Dragging or pasting Immich photos into a local folder copies them. Nothing is removed from Immich. In the Paste menu, Move image here is greyed out for Immich photos.
- Remove from Album removes a photo from the real Immich album.
- Delete Image moves the photo to Immich's trash. Delete + Associated trashes the whole stack.
Example: edit on the laptop, finish on the desktop
- On your laptop, open the Immich timeline, cull the last trip with
Shift+P/Xand do quick edits. - At home on your desktop, open the same album. Your picks and edits are already there.
- Finish the edits with the bigger screen and export to Immich with Album the image was opened from. The exports appear in the album, stacked on top of the originals.
RapidRAW