Why this Configuration?
- True Data Sovereignty: 100% GDPR-compliant on-premises deployment. You own your configuration and data without vendor lock-in.
- Hardware Agnostic: Optimized and verified across low-power ARM64 SBCs (Raspberry Pi 5) and x86_64 hypervisors (Proxmox VE LXC & VM).
- Engine Freedom: Tested and supported under standard Docker Engine and unprivileged rootless Podman.
- Platform Verification: Tested on Proxmox VM: docker (v3.2.2, 2026-09-27).
Quick Start (Standalone Docker Compose)
The snippet below is immediately ready to run in any standard Docker or Podman environment:
services:
immich-kiosk:
container_name: njorddeploy-immich-kiosk
image: ghcr.io/damongolding/immich-kiosk:0.44.1
tty: true
restart: unless-stopped
ports:
- "2284:3000"
environment:
- "KIOSK_IMMICH_URL=http://njorddeploy-immich-server:2283"
- "KIOSK_IMMICH_API_KEY=initial_setup_token"
- "KIOSK_DURATION=60"
- "TZ=Europe/Amsterdam"
networks:
- njorddeploy_net
networks:
njorddeploy_net:
Start the service directly via the command line: docker compose up -d
Configuration & Environment Variables
Key configuration parameters and defaults derived from the NjordDeploy component template:
| Variable | Default Value | Description |
|---|---|---|
IMMICH_KIOSK_PORT |
2284 |
Port to access the Immich Kiosk web interface. |
KIOSK_IMMICH_URL |
http://njorddeploy-immich-server:2283 |
Internal or external URL to the Immich server (e.g. http://njorddeploy-immich-server:2283). |
KIOSK_IMMICH_API_KEY |
initial_setup_token |
API Key generated in Immich (Account Settings -> API Keys). |
KIOSK_DURATION |
60 |
Duration in seconds each photo remains on screen. |
Ecosystem & Enterprise Integration
- Reverse Proxy Ingress Ready: Pre-configured for Caddy, Traefik, or Nginx Proxy Manager with automatic Let's Encrypt TLS certificates.
- Zero-Trust Mesh VPN: Seamless integration with WireGuard or Tailscale/Headscale mesh networks for secure remote administration.
- Transactional State Backups: Ready for point-in-time database dumps and container-safe persistent volume freezing.
Effortless Management with NjordDeploy
Deploy, monitor, and update this service with a single click on your own hardware via the NjordDeploy Configurator.