# alangrainger/immich-public-proxy

Share your Immich photos and albums in a safe way without exposing your Immich instance to the public.

Repository: https://github.com/alangrainger/immich-public-proxy
Canonical: https://ross.abutalabs.com/products/immich-public-proxy
Homepage: https://docs.ipp.nz
Language: TypeScript
License: AGPL-3.0
License Family: copyleft
Topics: gallery, immich, privacy, security
Last push: 2026-08-25T21:42:39+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 48
- inputs: {"age_days": 673, "days_push": 8, "days_rel": 14, "gap_med": 1, "n_releases_24m": 84}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2198, forks 79 (observed 2026-08-28T04:06:25.448862+00:00)

## What it is
A stateless proxy that sits in front of a self-hosted Immich instance and serves only explicitly shared photos, videos, and albums to the public. It requires no API key and keeps the Immich instance fully locked away from the internet.

## Use cases
- share immich photos with friends without exposing my server
- embed a single immich image on a website
- create a password-protected public photo gallery
- share large photo albums publicly from self-hosted immich
- let visitors download selected photos as a zip
- safely publish shared links from immich to the internet

## When to choose
- you self-host Immich and want to share photos or albums publicly without exposing the instance
- you want password-protected shares and a gallery matching Immich's look
- you need a stateless, minimal-attack-surface proxy with no API key

## When to avoid
- you don't use Immich as your photo library
- you need full public access to your entire photo library rather than explicit shares
- you want a general-purpose reverse proxy rather than an Immich-specific one

## Facets
- artifact type: service
- maturity: active
- function: proxy, http-server, security, image-processing
- domain: self-hosted, privacy, security, media, photography, web-development
- platform: self-hosted
- tags: immich, photo-sharing, gallery, reverse-proxy, shared-links, typescript, docker, nodejs, web-server

## Member repositories
- alangrainger/immich-public-proxy (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:25.448862+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:47:08.665336+00:00, confidence not recorded.
  - readme: https://github.com/alangrainger/immich-public-proxy (fetched 2026-08-28T04:06:25.448862+00:00, sha b6375433d957)
  - homepage: https://docs.ipp.nz (fetched 2026-08-29T10:27:39.741809+00:00, sha 6e02c416a617)
  - site_page: https://docs.ipp.nz/introduction (fetched 2026-08-29T10:27:39.751186+00:00, sha 595052adf3a3)
- Data as of 2026-08-30T08:39:29.467469+00:00.