Portainer miss-configuration on version v3.3.6.

[WH-Yoshi]

I have searched the existing issues, both open and closed, to make sure this is not a duplicate report.

• Yes

The bug

New to immich and just tried to start it on portainer using the official documentation but with the default configuration the server goes on connection timeout for the database.

The OS that Immich Server is running on

Synology DSM 7.4

Version of Immich Server

v3.3.6

Version of Immich Mobile App

N/A

Platform with the issue

• Server
• Web
• Mobile

Device make and model

N/A

Your docker-compose.yml content

name: immich

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    volumes:
      - ${UPLOAD_LOCATION}:/data
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - stack.env
    ports:
      - "2283:2283"
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: false

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
    volumes:
      - model-cache:/cache
    env_file:
      - stack.env
    restart: always
    healthcheck:
      disable: false

  redis:
    container_name: immich_redis
    image: docker.io/valkey/valkey:9@sha256:c123e3715db63d06d4ad6964884037aa0d5d4d703939b9929954112889708e1d
    healthcheck:
      test: redis-cli ping | grep -q PONG || exit 1
    restart: always

  database:
    container_name: immich_postgres
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:bcf63357191b76a916ae5eb93464d65c07511da41e3bf7a8416db519b40b1c23
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
      POSTGRES_INITDB_ARGS: "--data-checksums"
      DB_STORAGE_TYPE: "HDD"
    volumes:
      - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
    shm_size: 128mb
    restart: always
    healthcheck:
      disable: false

volumes:
  model-cache:

Your .env content

UPLOAD_LOCATION=/volume2/Immich/library
DB_DATA_LOCATION=/volume2/Immich/postgres
IMMICH_VERSION=v3
DB_PASSWORD=<my_password>
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

Reproduction steps

1. All steps explained here : https://docs.immich.app/install/portainer

Relevant log output

immich-server :
...
Initializing Immich v3.3.6
Detected CPU Cores: 2
file:///usr/src/app/server/node_modules/.pnpm/postgres@3.4.9/node_modules/postgres/src/connection.js:262
    errored(Errors.connection('CONNECT_TIMEOUT', options, socket))
                   ^
Error: write CONNECT_TIMEOUT database:5432
    at connectTimedOut (file:///usr/src/app/server/node_modules/.pnpm/postgres@3.4.9/node_modules/postgres/src/connection.js:262:20)
    at Timeout.done [as _onTimeout] (file:///usr/src/app/server/node_modules/.pnpm/postgres@3.4.9/node_modules/postgres/src/connection.js:1059:8)
    at listOnTimeout (node:internal/timers:687:11)
    at process.processTimers (node:internal/timers:618:7) {
  code: 'CONNECT_TIMEOUT',
  errno: 'CONNECT_TIMEOUT',
  address: 'database',
�
  port: 5432
}
Node.js v24.22.1
...

Additional information

N/A

[bo0tzz]

Can you post the logs from the database container?

[WH-Yoshi]

Yes sorry that is indeed relevant log output...

Here :

Using HDD storage
PostgreSQL Database directory appears to contain a database; Skipping initialization
2026-11-08 15:55:11.105 GMT [1] LOG:  skipping missing configuration file "/var/lib/postgresql/data/postgresql.override.conf"
2026-11-08 15:55:11.106 GMT [1] LOG:  skipping missing configuration file "/var/lib/postgresql/data/postgresql.override.conf"
2026-11-08 15:55:11.962 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
2026-11-08 15:55:12.047 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432
2026-11-08 15:55:12.047 UTC [1] LOG:  listening on IPv6 address "::", port 5432
2026-11-08 15:55:12.215 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
2026-11-08 15:55:12.276 UTC [32] LOG:  database system was shut down at 2026-11-07 23:23:21 UTC
2026-11-08 15:55:12.400 UTC [1] LOG:  database system is ready to accept connections