Glitch somplace
Immich won't start - getting error "problem loading page". docker ps -a shows restarts on immich server and postgres database.
From Portainer logs:
Immich Server:
errno: -3001, code: 'EAI_AGAIN', syscall: 'getaddrinfo', hostname: 'database' } microservices worker error: Error: getaddrinfo EAI_AGAIN database, stack: Error: getaddrinfo EAI_AGAIN database at GetAddrInfoReqWrap.onlookupall [as oncomplete] (node:dns:122:26) microservices worker exited with code 1 Killing api process And on Postgres database: PostgreSQL Database directory appears to contain a database; Skipping initialization 2025-11-06 23:06:28.353 GMT [1] LOG: skipping missing configuration file "/var/lib/postgresql/data/postgresql.override.conf" 2025-11-06 23:06:28.353 GMT [1] LOG: skipping missing configuration file "/var/lib/postgresql/data/postgresql.override.conf" 2025-11-06 23:06:28.545 UTC [1] LOG: starting PostgreSQL 14.19 (Debian 14.19-1.pgdg12+1) on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14+deb12u1) 12.2.0, 64-bit 2025-11-06 23:06:28.546 UTC [1] LOG: listening on IPv4 address "0.0.0.0", port 5432 2025-11-06 23:06:28.546 UTC [1] LOG: listening on IPv6 address "::", port 5432 2025-11-06 23:06:28.653 UTC [1] LOG: listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432" 2025-11-06 23:06:28.778 UTC [32] LOG: database system was shut down at 2025-10-31 21:45:35 UTC 2025-11-06 23:06:28.778 UTC [32] LOG: invalid primary checkpoint record 2025-11-06 23:06:28.778 UTC [32] PANIC: could not locate a valid checkpoint record 2025-11-06 23:06:28.952 UTC [1] LOG: startup process (PID 32) was terminated by signal 6: Aborted 2025-11-06 23:06:28.952 UTC [1] LOG: aborting startup due to startup process failure 2025-11-06 23:06:28.955 UTC [1] LOG: database system is shut down I'm new to this Linux stuff, and no luck sorting this out. Previous info on Discord really didn't explicitly show all steps to solve.
How to fix and get Immich running again?
From Portainer logs:
Immich Server:
errno: -3001, code: 'EAI_AGAIN', syscall: 'getaddrinfo', hostname: 'database' } microservices worker error: Error: getaddrinfo EAI_AGAIN database, stack: Error: getaddrinfo EAI_AGAIN database at GetAddrInfoReqWrap.onlookupall [as oncomplete] (node:dns:122:26) microservices worker exited with code 1 Killing api process And on Postgres database: PostgreSQL Database directory appears to contain a database; Skipping initialization 2025-11-06 23:06:28.353 GMT [1] LOG: skipping missing configuration file "/var/lib/postgresql/data/postgresql.override.conf" 2025-11-06 23:06:28.353 GMT [1] LOG: skipping missing configuration file "/var/lib/postgresql/data/postgresql.override.conf" 2025-11-06 23:06:28.545 UTC [1] LOG: starting PostgreSQL 14.19 (Debian 14.19-1.pgdg12+1) on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14+deb12u1) 12.2.0, 64-bit 2025-11-06 23:06:28.546 UTC [1] LOG: listening on IPv4 address "0.0.0.0", port 5432 2025-11-06 23:06:28.546 UTC [1] LOG: listening on IPv6 address "::", port 5432 2025-11-06 23:06:28.653 UTC [1] LOG: listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432" 2025-11-06 23:06:28.778 UTC [32] LOG: database system was shut down at 2025-10-31 21:45:35 UTC 2025-11-06 23:06:28.778 UTC [32] LOG: invalid primary checkpoint record 2025-11-06 23:06:28.778 UTC [32] PANIC: could not locate a valid checkpoint record 2025-11-06 23:06:28.952 UTC [1] LOG: startup process (PID 32) was terminated by signal 6: Aborted 2025-11-06 23:06:28.952 UTC [1] LOG: aborting startup due to startup process failure 2025-11-06 23:06:28.955 UTC [1] LOG: database system is shut down I'm new to this Linux stuff, and no luck sorting this out. Previous info on Discord really didn't explicitly show all steps to solve.
How to fix and get Immich running again?
30 Replies
:wave: Hey @Steve,
Thanks for reaching out to us. Please carefully read this message and follow the recommended actions. This will help us be more effective in our support effort and leave more time for building Immich :immich:.
References
- Container Logs:
docker compose logs docs
- Container Status: docker ps -a docs
- Reverse Proxy: https://immich.app/docs/administration/reverse-proxy
- Code Formatting https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline#h_01GY0DAKGXDEHE263BCAYEGFJA
Checklist
I have...
1. :blue_square: verified I'm on the latest release(note that mobile app releases may take some time).
2. :blue_square: read applicable release notes.
3. :blue_square: reviewed the FAQs for known issues.
4. :blue_square: reviewed Github for known issues.
5. :blue_square: tried accessing Immich via local ip (without a custom reverse proxy).
6. :blue_square: uploaded the relevant information (see below).
7. :blue_square: tried an incognito window, disabled extensions, cleared mobile app cache, logged out and back in, different browsers, etc. as applicable
(an item can be marked as "complete" by reacting with the appropriate number)
Information
In order to be able to effectively help you, we need you to provide clear information to show what the problem is. The exact details needed vary per case, but here is a list of things to consider:
- Your docker-compose.yml and .env files.
- Logs from all the containers and their status (see above).
- All the troubleshooting steps you've tried so far.
- Any recent changes you've made to Immich or your system.
- Details about your system (both software/OS and hardware).
- Details about your storage (filesystems, type of disks, output of commands like fdisk -l and df -h).
- The version of the Immich server, mobile app, and other relevant pieces.
- Any other information that you think might be relevant.
Please paste files and logs with proper code formatting, and especially avoid blurry screenshots.
Without the right information we can't work out what the problem is. Help us help you ;)
If this ticket can be closed you can use the /close command, and re-open it later if needed.
yml file, first part:name: immich
services:
immich-server:
container_name: immich_server
image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
# extends:
# file: hwaccel.transcoding.yml
# service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
volumes:
# Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATI>
- ${UPLOAD_LOCATION}:/data
- /etc/localtime:/etc/localtime:ro
env_file:
- .env
ports:
- '2283:2283'
depends_on:
- redis
- database
restart: always
healthcheck:
disable: false
2nd part: 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}
# extends: # uncomment this section for hardware acceleration - see https://docs.immich.app/features/ml-hardware-acceleration
# file: hwaccel.ml.yml
# service: cpu # set to one of [armnn, cuda, rocm, openvino, openvino-wsl, rknn] for accelerated inference - use the
-wsl v>
volumes:
- model-cache:/cache
env_file:
- .env
restart: always
healthcheck:
disable: false
redis:
container_name: immich_redis
image: docker.io/valkey/valkey:8@sha256:81db6d39e1bba3b3ff32bd3a1b19a6d69690f94a3954ec131277b9a26b95b3aa
healthcheck:
test: redis-cli ping || exit 1
restart: always
database:
container_name: immich_postgres
image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:bcf63357191b76a916ae5eb93464d65c07511da41e3bf7a841>
environment:
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_USER: ${DB_USERNAME}
POSTGRES_DB: ${DB_DATABASE_NAME}
POSTGRES_INITDB_ARGS: '--data-checksums'
# Uncomment the DB_STORAGE_TYPE: 'HDD' var if your database isn't stored on SSDs
# DB_STORAGE_TYPE: 'HDD'
volumes:
# Do not edit the next line. If you want to change the database storage location on your system, edit the value of DB_DATA_LO>
- ${DB_DATA_LOCATION}:/var/lib/postgresql/data
shm_size: 128mb
restart: always
volumes:
model-cache:Your database is corrupted
You'll need to restore a backup
New install, no backup.
Tried to reinstall multiple times, obviously don't know how to fully reinstall.
docker down command and then following instructions on immich site for installation didn't change result.
I don't have a link rn but check the faq
Which FAQ?
On the docs site
sorry, I'm new, and need very basic help.
what is docker ps output
i had this "getaddinfo database" when i had the db on a different network than immich expected
did the docker compose down and containers are no longer shown
tried to delete postgres database, but can't seem to do so
docker rm (containerid)?

you need to do
" docker rm" to remove the container
did that - and says error from daemon: no such container: postgres
But do an ls -al, and it's still there.
your container name from the yaml you posted seems to be "immich_postgress"
when you do ls -al in that folder, you are seeing a list of files or folders from your linux machine, that postgress ij the screenshot is a folder
the folder where the container had its data
when you stop the container, this folder remains (if it is set as bind)
if you do "docker ps "and there are no containers, then the container is stopped
docker ps shows containers are stopped.
you can try to delete the postgreas folder and then docker compose up again if the database is indeed corrupted
in the immich-app folder
sudo rm -r postgress
also your postgres folder has user dnsmasq and group root
deleted the postgres folder
i dunno why
Neither do I. I spotted that as well, but my rookieness didn't make any sense to me.
you could try to remake the stack now
docker compose up -d
ok, trying

in linux the users and groups are important, your docker compose is
user group
steve steve
running it should make the folders have the same user and group, unless you run
sudo docker compose up -d
then it will be
root root
It now works! Thank you!

But the odd group (or user?) is still there...
Just a meaningless coincidence of the container's internal uid overlapping with the one of dnsmasq on your host
I"m good for now - thanks for the help.