Immich on Debian with Podman + systemd (Ansible)

Quick start

1. Edit inventory and variables:

   • inventory/hosts.ini
   • group_vars/all.yml (set immich_db_password)

2. Run: ansible-playbook -i inventory/hosts.ini site.yml

Notes

• Systemd unit files are installed under /etc/systemd/system.
• Data lives under /opt/immich by default. Adjust variables in group_vars/all.yml or via -e.

Ports

• Host: immich_server_port -> Container: 3001 (Immich HTTP). Default host port is 2283.
• Redis/Postgres/Microservices/ML are internal-only on the Podman network (no host ports published).

Nginx reverse proxy example

server {
    listen 80;
    server_name immich.example.com;

    client_max_body_size 0;

    location / {
        proxy_pass http://127.0.0.1:2283;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}