Eighteen changes since v0.14.0. See CHANGELOG.md for the full list and the upgrade notes (bump IMAGE_CACHE_VERSION).
Documentation
Start at the project README for the pitch, the feature list and a quick start.
Guides
| Guide | Covers |
|---|---|
| Gallery Configuration | gallery.yaml and settings.yaml — albums, subpages, sections, photo order, passwords, grid, SEO, proofing, watermark |
| Theming | The seven presets, custom colours and fonts, hero styles, grid layouts, with screenshots |
| Journal & Photo Essays | Long-form storytelling — file format, block syntax, drafts, per-entry passwords, Journal Studio |
| Admin Panel | The visual editor at /admin — pages, journal, settings, analytics, backups, security |
| Deployment | Setup wizard internals, Docker, health check, reverse proxy, behaviour during an Immich outage |
Contributing? See CONTRIBUTING.md. Security policy: SECURITY.md. Release history: CHANGELOG.md.
Design notes
Working documents kept for context. They record thinking at a point in time and are not maintained — where they disagree with the guides above, the guides are correct.
- brainstorm.md, brainstorm-2026-08-05.md — feature brainstorming
- deep-dive-2026-08-05.md — architecture review
- ideas.md — unsorted ideas backlog
- journal-studio-design.md — design notes for the journal editor
screenshots/ holds the images used by the guides and the README.