Quick Start

Quick Start

Get Albm running with Docker in a few minutes.

Prerequisites

• Docker and Docker Compose
• A host you can put a reverse proxy in front of (HTTPS required for passkeys)

Clone and run

git clone https://github.com/Kristian-Buriasco/albm.git
cd albm

export SESSION_SECRET=$(openssl rand -hex 32)
export BASE_URL=https://gallery.example.com   # your real https origin

docker compose up -d --build
docker compose logs -f            # first run prints a temporary admin password

First login

1. Open the site → log in at /admin/login with the password from the logs
2. Add a passkey under Settings → Security
3. Put a reverse proxy (Caddy, nginx, Nginx Proxy Manager, …) in front for HTTPS — passkeys need a secure origin

Prebuilt image

Image: ghcr.io/kristian-buriasco/albm — pin a version in production, not :latest.

docker run -e SESSION_SECRET=$(openssl rand -hex 32) -v gallery:/data \
  -p 3200:3200 ghcr.io/kristian-buriasco/albm:latest

Next steps

• Configuration — env vars and data layout
• Deployment — updates, health checks, bare metal
• Security — operator checklist