Studio
Leica-inspired, red dot |
Minimal
Swiss brutalist, fullbleed hero |
 |
 |
Editorial
Cinematic magazine, warm charcoal |
Classic
Gilded gallery, gold accents |
 |
 |
Noir
Darkroom analog, film noir |
Monograph
Typographic, book-like |
 |
 |
→ **[Theming Guide](docs/theming.md)**
## Docker
### Docker Compose (recommended)
```yaml
services:
lightbox:
build: .
container_name: immich-folio
restart: unless-stopped
ports:
- '7211:7211'
env_file:
- .env.local
volumes:
- ./content:/app/content:ro
```
Run with:
```bash
docker compose up -d
```
The gallery will be available at `http://localhost:7211`.
### Standalone Docker
```bash
# Build
docker build -t immich-folio .
# Run
docker run -d \
--name immich-folio \
--restart unless-stopped \
-p 7211:7211 \
--env-file .env.local \
-v ./content:/app/content:ro \
immich-folio
```
> **Note:** The `content/` volume mount lets you update `gallery.yaml` and `about.md` without rebuilding the image.
### Health Check
The container includes a built-in health check at `/api/health`:
```bash
curl http://localhost:7211/api/health
```
### Reverse Proxy
Put Immich Folio behind nginx / Caddy / Traefik with TLS. Example Caddy config:
```
photos.example.com {
reverse_proxy localhost:7211
}
```
## Tech Stack
- **Next.js 16** (App Router, standalone output)
- **React 19**
- **TypeScript**
- **Vanilla CSS** (no framework)
## License
MIT License — free to use and modify for the Immich community.
