markusthiel/lumio

What is it?

Key features

• 01Client proofing with likes, color tags, star ratings, comments, and drawn annotations
• 02Video review with time-anchored annotations and filmstrip scrubbing
• 03RAW support for common camera formats via LibRaw
• 04Print shop for selling prints, canvases, and photo books from galleries
• 05AI auto-tagging with CLIP and confidence-based filtering
• 06Whitelabel branding with custom logos, colors, and domains
• 07Signed URLs, two-factor authentication, audit log, and GDPR data processing agreement

Use cases

• A photographer delivering proof galleries to clients who choose their final images
• A studio that wants to keep client photos and personal data on its own server for GDPR reasons
• An agency hosting galleries for several photographer clients on one instance
• A photographer selling prints and photo books to clients directly from their gallery

Quick start

1. 1

   Get the repo

   git clone https://github.com/markusthiel/lumio.git
2. 2

   Start the containers (first start takes 3–5 min)

   docker compose up -d
3. 3

   Create an admin user

   docker compose exec api npm run create-admin -- --email=you@example.com --password=atleast12chars --name="Your Studio"
4. 4

   Open http://localhost in your browser and log in

Things to know

• !Licensed under the source-available FSL-1.1-ALv2, not OSI open source, and offering it as a competing hosted SaaS to third parties is not permitted.
• !Requires Docker with Compose v2 and self-hosting effort, including opening ports 80 and 9000 on your server.

In collections

Topics

FAQ

What is lumio?

Self-hosted photo and video gallery for photographers, with client proofing, print shop, and AI auto-tagging. Lumio is a self-hosted gallery for photographers and studios. Photographers upload photos and videos, share a gallery link with clients, and clients select favorites, assign color tags, rate images, and leave comments. Videos can be reviewed at specific timestamps, and annotations can be drawn directly on photos and video frames.

Is lumio free to use? What license does it have?

lumio is open source under the Other license. Check the license terms before using it in commercial products.

Is lumio still maintained?

Actively maintained. The last commit to lumio was on Nov 5, 2026.

What can I use lumio for?

A photographer delivering proof galleries to clients who choose their final images A studio that wants to keep client photos and personal data on its own server for GDPR reasons An agency hosting galleries for several photographer clients on one instance A photographer selling prints and photo books to clients directly from their gallery

How do I install lumio?

Get the repo: git clone https://github.com/markusthiel/lumio.git Start the containers (first start takes 3–5 min): docker compose up -d Create an admin user: docker compose exec api npm run create-admin -- --email=you@example.com --password=atleast12chars --name="Your Studio" Open http://localhost in your browser and log in

Where can I get lumio?

The source code and installation instructions are on GitHub: https://github.com/markusthiel/lumio