Immich-folio

Immich Folio is a lightweight, self-hosted web application that turns your Immich albums into a public photography portfolio.

  • Media Applications
  • Tools & Utilities
  • Web & Publishing
Immich Folio is a lightweight, self-hosted web application that turns your Immich albums into a public photography portfolio. It acts as a secure reverse proxy, letting visitors browse your published gallery without exposing your private Immich server to the internet. Ideal for photographers who want a polished public showcase while keeping their Immich instance on the local network.

Platform availability

Available on 1 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 (not listed)

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.

63/100 Good

Maintained
100last commit 17 days ago
Popular
3241 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
106 GB minimum RAM
Security check
94no serious findings, 1 minor, CI, tests

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

GitHub stars
41
Open issues
50
Last commit
2026-11-04
Latest release
v0.22.0
License
MIT
Activity
declining

Checked 7 days ago - source: GitHub (ralksta/immich-folio)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 2 CPU core(s).

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

First-install notes

  • Fill in your Immich address and API key Edit the config.yaml file and set immich_api_key and immich_url to your Immich server details; without these, the kiosk can't connect or load photos. source
  • Save your settings in the config folder Create a config folder and keep the edited config.yaml there; that file controls which photos and people are shown, so losing or misplacing it means starting over. source
  • Start the Docker container after setup After saving your config.yaml, run docker compose up -d to start the kiosk container (a self-contained app package) in the background. If you skip this, the kiosk will not launch and you will not see any photos. source
  • First-Run Setup Before first launch, set AUTH_SECRET to a long random string (required for session security and encryption). On first start, find the generated setup token in the container logs (Unraid → Container Logs), then enter it in the web setup wizard along with your Immich URL, API key, and admin password. Leave ADMIN_PASSWORD blank initially; you can set it later via environment variables to reset or ove source

Fetched 47 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 complete the first-run setup wizard?

After starting the container for the first time, check the container logs for the generated Setup Token. Enter that token in the Web UI along with your Immich URL, API key, and admin password.

What environment variables are required?

Set a long random AUTH_SECRET for session security and encryption. ADMIN_PASSWORD is optional during initial setup and can be populated later.

Does serving the Folio gallery expose the Immich server?

No. Immich Folio acts as a secure reverse proxy between visitors and your private Immich instance, keeping the Immich server on your local network and invisible to the internet.

Which Immich permission is needed for photo downloads and zoom?

The setup guide names the asset.download permission as needed for zoom and downloads.

Where can I troubleshoot the Unraid container?

The dedicated Unraid support thread for the Immich-Folio Docker container in Community Apps is for understanding and troubleshooting the container.

Answers sourced from forums.unraid.net, github.com

Community

Collected 48 days ago - public community threads