Skip to content

Use a Podman Network for Container Communication

linux-universe edited this page Mar 19, 2026 · 2 revisions

Use a Podman Network for Container Communication

By default, all containers run in a single pod. This guide removes the pod and runs each container independently within the same Podman network.

Note

This guide is based on the quadlet files in main.

  1. You can delete the immich.pod file.

  2. Create a file named immich.network

    [Network]
    NetworkName=immich
    #IPv6=true
    
  3. Replace the following lines in every file ending with .container:

    + Network=immich.network
    - Pod=immich.pod
  4. Remove and add the following lines in immich-server.container:

      [Unit]
      Description=Immich Server
      Requires=immich-redis.container immich-database.container
    + Wants=immich-machine-learning.container
    
      [Container]
      #AutoUpdate=registry
    + Network=immich.network
    - Pod=immich.pod
      Image=ghcr.io/immich-app/immich-server:${IMMICH_VERSION}
      Volume=${UPLOAD_LOCATION}:/data:z
      Volume=/etc/localtime:/etc/localtime:ro
      Environment=TZ=${TZ}
      Environment=DB_PASSWORD=${DB_PASSWORD}
      Environment=DB_USERNAME=postgres
      Environment=DB_DATABASE_NAME=immich
    + PublishPort=2283:2283
    - Environment=DB_HOSTNAME=localhost
    - Environment=REDIS_HOSTNAME=localhost
    + Environment=DB_HOSTNAME=systemd-immich-database
    + Environment=REDIS_HOSTNAME=systemd-immich-redis
      #AddDevice=/dev/dri
    
      [Service]
      TimeoutStartSec=900
    +
    + [Install]
    + WantedBy=default.target
  5. You can start and stop the Pod with systemctl start/stop immich-pod.service

Note

You need to change the machine learning URL in the admin settings to http://systemd-immich-machine-learning:3003 in order for it to work.

Clone this wiki locally