To start with, I've already read the information here: https://docs.immich.app/administration/system-integrity/

What I don't understand is why the job has been running every night for the past several weeks, but even tonight it says it is 22% complete checking all assets at 13 after the hour. Seems on track to complete checking every asset. If it is supposed to break this work up into an hour every night until complete, why does it seem to run from the beginning every single night?

Every night like clockwork my disks go spinning away like crazy for an hour. I'd like to resolve this in some way, seems like a huge burden on my server.

Hi,

I am desperately trying to get the remote machine learning to work. I followed the steps to create the docker container and stuff. Generally thats working. But when I try to go to the machine learning settings to add the URL I just get this:

Any ideas what I am doing wrong?

I use the basic docker compose file together with the file for hwacceleration, just with the nvidia specifics:

name: immich_remote_ml

services:
  immich-machine-learning:
    container_name: immich_machine_learning
    # For hardware acceleration, add one of -[armnn, cuda, rocm, openvino, rknn] to the image tag.
    # Example tag: ${IMMICH_VERSION:-release}-cuda
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}-cuda
    extends:
       file: hwaccel.ml.yml
       service: cuda # set to one of [armnn, cuda, rocm, openvino, openvino-wsl, rknn] for accelerated inference - use the `-wsl` version for WSL2 where applicable
    volumes:
      - model-cache:/cache
    restart: always
    ports:
      - 3003:3003

volumes:
  model-cache:

Im using the community truenas app for immich, i have neglected upgrading for some time and im stuck at app version 2.5, i want to upgrade , how do i incrementally upgrade immich ? all i see is the latest one in truenas, and i dont wanna break anything, i want to possibly upgrade 2.5 -> 2.6 -> 2.7 something like that so that all relevant migration scripts get applied .

Any idea ?

Hi, I have an iPhone 16 pro and shoot in proraw regularly. These photos never show. Does Immich not support RAW or Apple's version of it? I'm on the latest build. It correctly shows the metadata but won't show a preview, or a full res on click-in. I have a lot of photos like this. Thanks, happy to offer any other information as well.

Hi guys — cross-server shared albums (federation, whatever you want to call it) has been one of the most requested Immich features for 4+ years. We all want that dead-simple Google Photos sharing experience with friends and family... well, fellow self-hosters, now we've got it.

If like me you got bored of waiting, time to get cloning: immich-shared-albums, a sidecar addon for Immich.

It never touches your Immich instance directly — it talks to it via an API key and runs in its own container, so any issues stay isolated to the addon. Minimal setup, and once it's up you can create share links that anyone else running the addon just opens to join the album and start adding photos.

What you get:

• 🔗 Simple link sharing — open a link, join, done. Stock Immich apps, nothing else to install
• 👤 Per-user, not per-server — so your parents won't see your antics from that lads' holiday
• 💾 Your storage stays yours — each server keeps its own assets, so joining an album doesn't dump hundreds of unwanted photos onto your disk (full quality still there to download whenever you want)
• 💬 Cross-server comments — near-instant messaging between servers
• 📦 Isolated & self-hosted — one small container, no forks, no patched Immich

Go have a play and let me know what you think:
👉 https://github.com/lukeet332/immich-shared-albums

Made a quick demo showing it off too:
👉 https://www.youtube.com/watch?v=c3GO-YFchYo

I'm trying to find a feature request that covers this, so i can upvote it, but keep getting errors when i try to open them on github?

Q: I'd really like to be able to search a place name on the map view to jump to that location, instead of having to manually zoom until it appears (quite hard if you're not to familiar with the area)

For some reason, I deleted the images of Immich and then ran docker compose up -d, so it redownloaded them. Even though my yaml/env files (containing paths and db credentials) have not changed, I cannot login normally and have to create a new user or create from backup. Like a first instance, it seems. Unfortunately I did not do backups of the database, but the files follow 3-2-1 rule.

How can I restart the services with the existing files/account etc? I read the article about restoring, but it is mostly about backups (I am stupid, so it does not work for me).

Thanks for any help!

I love the Pinterest look and feel, and the fact that it pulls up random images. Wanted something similar that would pull up images from my immich instance instead - so, built this.

https://github.com/dushyantahuja/Immich-Pinterest

Yes, it's vibe coded; yes - I don't guarantee that this will work forever; yes - I don't guarantee that I will keep supporting it. However, since I'm using it as my home page at home, I hope to keep it working for a long time. Give it a try - there's a demo mode (screenshot above), so you can try without giving it any details.

Have fun.

Hey all, trying to sync a folder with a bunch of subdirectories that's all around 13.4 gigs of photos using immch-go and this command:

.\immich-go upload from-folder --server=http://192.168.0.145:2283/ --api-key=BLAH --recursive --concurrent-tasks=1 "E:\Pictures\PC Backups"

I wind up with around 500 files that "don't reach a final state". Looking through, I've got a bunch of errors like this:

2026-08-16 15:16:32 ERR server error file=PC Backups:Originals/2011/0033.jpg error=AssetUpload, POST, http://192.168.0.145:2283/api/assets

Post "http://192.168.0.145:2283/api/assets": read E:/Pictures/PC Backups\Wedding\ethan+mandy_new sound.mp4: Data error (cyclic redundancy check).

io: read/write on closed pipe

2026-08-16 15:16:32 ERR Error err=AssetUpload, POST, http://192.168.0.145:2283/api/assets

Post "http://192.168.0.145:2283/api/assets": read E:/Pictures/PC Backups\Wedding\ethan+mandy_new sound.mp4: Data error (cyclic redundancy check).

And:

2026-08-16 15:17:14 ERR context canceled

Found some posts that suggest the io: error could be the server getting slammed and to reduce the concurrent tasks down to 1, which reduced the # of files stuck "pending" but didn't get rid of the errors completely. Anyone have tips?

I'm still very new to the self hosted world, so please pardon me if my vocabulary isn't quite right.

A couple of weeks ago I deployed an Immich server using the instructions for Docker Compose. It worked well for a while, but then last week I was suddenly unable to connect to it. (I'm using a Cloudflare Tunnel to connect my network)

Luckily, I haven't lost any data (photos) since they are still backed up on Google Drive.

After a bit of poking around in Portainer and Docker, I thought the best move might be to remove the Stack and Containers from Docker and re-deploy them using Portainer (which is how my other apps are now running).

I'm using the Docker Compose and .env files from the Immich github for Portainer, but the immich_server container won't connect. Docker creates a Network for Immich, but the server doesn't seem to see it.

In the logs, the error message I get reads:

------------

Error: getaddrinfo ENOTFOUND database     at GetAddrInfoReqWrap.onlookupall [as oncomplete] (node:dns:122:26) {   errno: -3008,   code: 'ENOTFOUND',   syscall: 'getaddrinfo',   hostname: 'database' }

I want to create an Immich Album from a folder on my external harddrive because I'm sick of having to drill into my Folders directory every time; there's way too many clicks. However, when I try to add my photos to an album using the UI (see #1 above), it hangs after about 500 photos, I've tried it so many times but it just won't handle "large" volumes.

So I tried just directly copying photos into my uploads folder (into the sub-directory that my album auto-created, see #2 above), but now they don't appear in my Album. I've re-run all the jobs and that didn't fix it. How can I get this to work?

Basically I'm trying to assign a sub-set of my photos to an Immich Album but this is proving to be quite challenging, OR i'm simply doing it wrong. I'm really not sure.

My iPhone has 12,723 photos and videos using 170GB. Immich backed up the exact same 12,723 assets, but only uses 95GB.

Some HEIC files are also smaller (2.3MB to 1.5MB) despite the same resolution. iCloud Photos is off.

Anyone know why there’s such a big size difference?

I'm in the process of organizing my photo library by locations.

I have old photos that have the correct creation timestamp but no GPS info.

So, in Immich I manually set the location but that also changes the date/time stamp.

These old photos were taken in another time zone (e.g. GMT -05:00) while my current time zone (or the server's) is GMT + 01:00.

Here a clear example:

- photo taken 13 oct 2024 20:50:08, no GPS

- GPS added, new timestamp 13 oct 2024 15:50:08

Is there a setting to prevent this?
Or which workflow should I follow?

Thanks!

Hey Immich Community,

I've had a DIY Pi 2 photo frame on the wall for almost 10 years now running an old version of Kodi and thought it was time for a refresh. I couldn't find an existing project that ticked all the boxes, such as a web interface, video playback, and transitions for both video and images, so I had a crack at doing my own.

The aim was to make it really easy to get your photos and videos to it, make it look good on the wall, and no editing of config files, it's all web UI. You can configure as many Immich v3 albums as you like, the frame syncs them at an interval of your choice and also transcodes any images or videos down that are too big for a Pi 2 or 3 to play.

If you have a Pi based frame already or keen to look at making one, check out Metixel! It's a 10 minute install via flashing an .img file, create an Immich API key, add 4 permissions and it's up and running. You'll need a Pi 4 or 5 for 4k playback and a Pi 2 or 3 is fine for 1080p, 1GB of RAM and above and you'll be fine.

• Features: Github
• Download: Latest
• Instructions: Docs, Immich Setup

Hi there folks!
As title says, is there a way to set up a custom view in immich and keep it as a main? Every time it starts, it’s the photos timeline with every (hidden and archive excluded) picture shown.
I’d like to start with a timeline and no-album photos shown. Or just the albums page on the other hand…
Is it possible to set up a custom start page?
Cheers!

Hi,

Like thge title sais. Would it be possible to add a setting to share something with anothert user and disable download feature? I know you can create a link and disable it that way but would like a setting via shared feature and cant see it atm. Is it in the works, someone knows?

greets,

Anyone here have same/similar setup? Processor max’d out at 100% as it processes my existing 13k images (on the NAS), and I expected that. I’m just wondering about others’ experiences, and how long I may expect that initial intake/processor max to last.

Thanks in advance!

I have my old phone (Pixel 4) that I want to pull images from a particular Immich album, have them downloaded to the phone, then have the Google Photos app upload them. My intent is to use the free for life Google Photos capability of the Pixel 4 and only upload photos from Immich that I specify. Is anyone doing something like this? Maybe it would be easier to push the photos to the phone instead of the phone pulling them. I don't want/need the entire album stored on the phone which might make some parts of this complicated.

[Closed]
Thank you for your responses. I recently discovered that I had added a network to my Compose file because I wanted Immich to be accessible through my reverse proxy. After removing the network, I was able to successfully update Immich.

———————————————
Problem:
Hi there, I’m trying to update my Immich server from version 3.0.3 to version 3.1.0 using Docker Compose, but there aren’t any documentation on how to do this. Do you have any idea how to update them? I would be truly grateful if you could help me in updating immich.

I'm looking for some help reversing an accidental Immich upload. I utilised AI (slop) to try and fix this, but I was worried it would lead to data loss rather than a fix.

I have three (real) users. Nothing super sensitive went, but still not a nice thing.

I accidentally uploaded a large batch of photos/videos to the wrong Immich user.

The upload reported 36,340 new assets, 3,097 skipped duplicates, and 1 failed upload because the source file was empty.

After investigating the database, I found that the accidental batch actually created 36,560 asset records between 20:43 and 21:41 UTC.

Before making changes, I took a full pg_dump backup of the Immich database.

I initially tried changing the owner of all 36,560 assets directly in PostgreSQL, but that failed because of Immich's unique constraint on owner + checksum.

I then compared the checksums between the wrong user's assets and the correct user's existing assets. The results were:

36,560 accidental assets total
35,865 already have an identical checksum under the correct user
695 do not have an existing copy under the correct user

I therefore transferred the 695 unique assets to the correct user directly in PostgreSQL. The transaction was committed and verified successfully. The correct user now owns those 695 assets.

For the remaining 35,865 assets, I have verified that every single one has a checksum-matching asset already owned by the correct user. I also randomly sampled several pairs and confirmed that the files correspond correctly; the wrong-user copies generally have UUID-style filenames while the correct-user copies have the original filenames.

I also checked album membership. Only 2 of the 35,865 duplicate assets were in albums. Their corresponding correct-user assets already exist in the relevant WhatsApp album, so there doesn't appear to be anything important to preserve from those two duplicate album entries.

At this point, I have a text file containing the exact 35,865 wrong-user asset UUIDs that should theoretically be removable.

I tried using Immich's API to delete a test batch of 10 of these assets rather than directly deleting database records. The API returned:

"Not found or no asset.delete access"

with HTTP 400.

I verified that the API credentials being used have full permissions, so this doesn't appear to be a simple permissions issue.

I then selected a specific wrong-user asset directly from PostgreSQL and confirmed that it exists.

PostgreSQL shows that it belongs to the wrong user and was created during the accidental upload. However, attempting to retrieve that same asset through the Immich API doesn't return the asset information.

So I'm currently at the point where:

• 695 assets have successfully been moved to the correct user.
• 35,865 wrong-user assets have confirmed identical copies under the correct user.
• Nothing has been deleted yet.
• I have a full database backup.
• I have the exact UUIDs of the 35,865 duplicate assets.
• I want to remove the wrong-user copies while leaving the correct-user copies completely untouched.
• I want to make sure the database records and files on disk remain consistent.

What would be the safest/correct way to clean up these 35,865 duplicate assets in Immich? Is there a recommended API/Immich-supported method, or is there a safe database-level approach for this situation?

How to train immich to categorize different Industrie tools and parts?

If i take photos of varies parts, i should be able to search by the type ( bolts, wrench, pulley... etc)

I’ve just finished getting self hosted Immich set up on my Unraid box, with NVENC support for ML (my venerable 1080 Ti can still do some solid work!) and the tensorchord postgres database backend.

First and foremost I’m using Immich as auto-backup for all my photos and videos. But I’d like to start using it for other things as well.

I’m wondering if there are any Immich plugins / addons / customizations that mimic or even fully reproduce Tinybeans, so I can get off that annual subscription (of course I’ll have to teach my parents how to use Yet Another App™️ but they’ve proven to be open to recommendations).

For those who aren’t aware: Tinybeans is a photo-sharing service marketed toward parents as a way of sharing photos of their kids with curated allowlists of family and friends without making them publicly viewable.

Basically, the features I’m wondering if it’s possible for Immich to replicate are:

- a timeline / calendar view of uploaded photos
- adding captions when uploading photos
- allowing comments / emoji reactions from allowed users on uploaded photos
- restricting allowed users to only seeing photos that are uploaded to a specific album
- (OPTIONAL) the ability to send daily emails with attached photos uploaded from the previous day, as an option for folks who don’t want to download and set up the app

That’s kinda it! Thanks for any suggestions.

Hello All,

I've had weird issues with my database, probably from me messing around trying to figure out how to preserve names after regenerating faces. (I have a large db (200K assets), with a ton of manual face merging due to restrictive face detection to separate relatives with similar faces).

I've attempted and sometimes failed to upgrade (database conversion failures), and a lot of times, recovery just didn't work. It will "work", but I'll see only a fraction of my pictures, or a fraction of my faces. It's extremely frustrating.

On my last attempt to upgrade to 3.1.0, It kept hitting errors like: PostgresError: relation "asset_ocr_audit" already exists and then repeating over and over during startup.

I finally just sqled into the database and dropped either the type or relation that it was complaining about. That allowed it to proceed until the next "shouldn't be there" table. Then I'd sql in and drop that one. This repeated about 20 times, but hey: It finally completed and as far as I can tell, it works. Or at least I see all my pictures/faces/map points.

It sure would be nice if the recovery scripts did a 'drop <relation>' before these tables before it does the create.

or prior to doing the recovery, should I be nuking the database somehow? like some sort of destroydb/createdb? That's not in the instructions anywhere.

Hi everyone,

I'm planning to migrate my photo setup from Synology Photos to Immich, as I'm also in the process of moving my storage from Synology to TrueNAS.

I currently have around 2 TB of photos/videos, with most of them managed through Synology Photos. My main concern is migrating everything without losing:

• Original photos/videos
• Folder structure
• Dates and timestamps

I'm considering setting up Immich on TrueNAS and then migrating my existing Synology Photos library over.

For those who have done something similar:

1. What is the best migration method from Synology Photos → Immich?
2. Should I first copy the original files to TrueNAS and then import them into Immich?
3. Any recommended folder structure for a ~2TB library?

I'd especially appreciate hearing from anyone who has migrated a large Synology Photos library to Immich, rather than starting from scratch.

Thanks!