Immich Kiosk

Self-Hosted

Open-source photo kiosk companion for Immich, ideal for digital frames or shared displays

Overview

Immich Kiosk is a self-hosted companion app for Immich that turns any device into a photo kiosk or digital frame. It displays curated albums, memories, or random photos from your Immich library with customizable slideshow transitions, timing, and playback modes. Deploy easily via Docker (using official compose files) on Raspberry Pi, tablets, smart TVs, or desktop browsers. Features include offline access to cached photos, password protection for restricted views, and auto-refresh to sync with latest Immich uploads—perfect for family spaces or office displays.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  immich_kiosk:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: immich-kiosk
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Seamless integration with Immich photo libraries
Customizable slideshows (transitions, timing, album selection)
Cross-device support (Raspberry Pi, smart TVs, tablets)
Docker & browser-based deployment options

Frequently Asked Questions

? Is Immich Kiosk hard to install?

No—install via Docker Compose with simple configuration (link to your Immich server URL and API key) or run as a web app in any modern browser. It works on Raspberry Pi, tablets, and smart TVs with minimal setup.

? Can I use Immich Kiosk without an Immich server?

No—Immich Kiosk is a companion app that relies on an active Immich self-hosted server to fetch and display your photo library. It cannot function independently.

? Is Immich Kiosk completely free?

Yes—Immich Kiosk is open-source under the MIT License, so it’s free to use, modify, and self-host with no hidden costs or subscription fees.

Top Alternatives

Google Photos Digital Frame Search Google

Amazon Echo Show (Photo Display Mode) Search Google

Samsung The Frame TV Search Google

Tool Info

Pricing Free/Open Source

Category Photo Galleries

Platform Self-Hosted

Pros

⊕ Privacy-focused (no third-party cloud dependency)
⊕ Fully open-source (MIT License)
⊕ Easy Docker setup with pre-built compose files
⊕ Syncs real-time with Immich library updates

Cons

⊖ Requires an active Immich server to function
⊖ Limited to display-only (no photo editing features)
⊖ Device-specific tweaks may be needed for smart TV compatibility
⊖ Basic UI (prioritizes playback over advanced customization)