Saturday, 14 November 2026

Install notes for immich server

Installing immich server on RHEL 9

Immich relies on docker containers, we can use podman which is functionally equivalent.

Prereqs:

  • install epel
  • install podman-compose

Firewall add immich port:

  •  firewall-cmd --permanent --add-port=2283/tcp
  •  firewall-cmd --reload

Follow the install guide:

Edit compose file to relabel for SELINUX
  •       ${UPLOAD_LOCATION}:/data:Z
  •       ${DB_DATA_LOCATION}:/var/lib/postgresql/data:Z

Run it:
  • podman compose up -d
check status:
  • podman ps -a

so it restarts on reboot
  • systemctl --user enable podman-restart.service
  • systemctl --user start podman-restart.service
To close it down:
  • podman compose down 

I've added my photos volume to the VM and will add it to immich as an external library
  • # Photos disk
  • UUID="06a489b3-9ae8-4023-afdc-bbf306d7be7e" /photos     xfs     defaults        0 2
Add the volume to the docker-compose.yml so it is available to immich
    volumes:
      # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UP
LOAD_LOCATION in the .env file
      - ${UPLOAD_LOCATION}:/data:Z
      - /photos:/photos:Z


To access it via SSL, you'll need a reverse proxy - here's my apache version of that.

  • <VirtualHost *:443>
  •    ServerName <your access FQDN here>

  •    RewriteEngine On
  •    # Check if the incoming request is asking for a WebSocket upgrade
  •    RewriteCond %{HTTP:Upgrade} websocket [NC]
  •    RewriteCond %{HTTP:Connection} upgrade [NC]
  •    # Redirect WebSocket traffic to the Immich backend using ws:// or wss://
  •    RewriteRule .* ws://192.168.0.115:2283%{REQUEST_URI} [P,L]

  •    ProxyRequests Off
  •    SSLProxyEngine On
  •    SSLEngine On
  •    ProxyPass / http://192.168.0.115:2283/
  •    ProxyPassReverse / http://192.168.0.115:2283/
  •    ErrorLog logs/photos-error_log
  •    CustomLog logs/photos-access_log combined
  • </VirtualHost>


 

No comments:

Post a Comment