Immich Public Proxy

Immich Public Proxy is a lightweight reverse proxy that serves your Immich photo and album share links to the public without exposing your Immich instance's…

  • Cloud
  • Media Applications
  • Security
  • Tools & Utilities
Immich Public Proxy is a lightweight reverse proxy that serves your Immich photo and album share links to the public without exposing your Immich instance's API or login endpoints, letting users offer safe public shares that stay managed within Immich and require no API key or privileged access.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

74/100 Good

Maintained
100last commit 22 days ago
Popular
682,407 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
206 GB minimum RAM, runs on ARM
Security check
100no serious findings, CI, tests

Availability: platform listings confirmed today, links checked 51 days ago

GitHub stars
2,407
Open issues
13
Last commit
2026-10-29
Latest release
v4.1.2
License
AGPL-3.0
Activity
declining

Checked 20 days ago - source: GitHub (alangrainger/immich-public-proxy)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 2 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Fill in Immich URL and API key Before starting the app, edit the downloaded config.yaml and add your Immich web address (immich_url) and API key, which is the secret code that lets the kiosk use your Immich account. Without these, the kiosk cannot reach your Immich server and will not show any photos. source
  • Keep the config folder safe Keep the config folder and its config.yaml file safe, because they contain your API key and your display choices. If they are lost, you have to set things up again, and a leaked key could let others access your Immich data. source
  • Start it after editing config After you finish editing the config, run the provided container-startup command (docker compose up -d) to start the service in the background. Starting it before the config is ready can mean it connects with missing settings and displays nothing. source

Fetched 54 days ago - each note links to its source

Alternatives (12)

  • Ente Photos - Open-source, end-to-end encrypted backup and sharing for photos and videos, with multi-platform sync, original quality, privacy controls, a…
  • Frameleaf Manager - Frameleaf Manager is the guided installer and upgrade tool for the self-hosted Frameleaf photo and video library.
  • Go-vod - Go-vod is a minimal, self-hosted video transcoding server for the Memories Nextcloud photo app that exposes stored media as HTTP Live Strea…
  • Google Photos - Cloud storage offering 15 GB free space, automatic album and duplicate organization, AI editing, cross-platform sharing, and secure backups.
  • HomeGallery - HomeGallery is a self-hosted, open-source web gallery for browsing personal photos and videos while keeping your original file and folder s…
  • PhotoPrism - PhotoPrism is a self-hosted, AI-powered photo and video manager.
  • Piwigo - Piwigo is a self-hosted, open-source photo gallery for the web that lets you publish, organise, and share your picture collection with powe…
  • Proton Drive - Emphasizes privacy with end-to-end encryption, Proton Drive safely stores, synchronizes, and shares files across devices via web and mobile…
  • TinyCld - Open source suite for mail, calendar, drive, and contacts with self-hosting, privacy, zero cost, open standards, versioned files, and unifi…
  • foldergram - Foldergram is a self-hosted, local-first web gallery that scans folders for photos and videos and displays them in a fast, Instagram-style…
  • immich-server
  • librephotos - LibrePhotos is a self-hosted, open-source photo management service for organizing and browsing photo and video collections.

Checked 40 days ago - source: AlternativeTo

Common questions

How do I make Immich generate share links through the proxy?

Set the External domain in Immich's Server Settings to the public URL of the proxy. New share links generated by Immich will point at the proxy instead of the Immich host.

Which proxy environment variables must I set during setup?

Set IMMICH_URL to the local, non-public URL of your Immich server and PUBLIC_BASE_URL to the public URL of the proxy.

How can I verify the proxy is configured correctly?

Request the /share/healthcheck path on the proxy's public URL. It should respond once the proxy is running and reachable.

What Cloudflare setting do I need for shared videos?

Set the /share/video/* path to Bypass Cache. Without that setting, videos may not play.

How can I fix DNS problems when the proxy cannot resolve IMMICH_URL?

Point IMMICH_URL at Immich's IP address to skip DNS resolution entirely. Alternatively, fix the resolver to return an empty NOERROR/NODATA response instead of NXDOMAIN for a missing AAAA record.

Does the proxy store share data or require an API key?

No. It is stateless, needs no API key, stores nothing, and only passes requests for publicly shared Immich items.

Answers sourced from docs.ipp.nz, github.com

Community

Collected 53 days ago - public community threads