ChronoFrame

ChronoFrame is a self-hosted photo gallery for homelab users who want a private, low-maintenance place to upload, organize, and share personal photos with…

  • Media Applications
ChronoFrame is a self-hosted photo gallery for homelab users who want a private, low-maintenance place to upload, organize, and share personal photos with metadata, location maps, albums, and live photos.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

78/100 Good

Maintained
100last commit 1 day ago
Popular
661,986 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
100no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
1,986
Open issues
35
Last commit
2026-11-21
Latest release
v1.2.0
License
AGPL-3.0
Activity
steady

Checked today - source: GitHub (HoshinoSuzumi/chronoframe)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

  • Make .env before starting Create a .env (a text settings file) before starting by copying .env.example and filling in the admin account, secret settings, and storage provider details. Without it, the app may launch but you may not be able to sign in or store files. source
  • Open port 3000 and a data folder When starting the Docker container, map port 3000 to your machine and mount a local ./data folder to /app/data, then open port 3000 in your firewall if you will access it over a network. Port 3000 is the web UI, often http://localhost:3000, and the local data folder keeps your files from disappearing when the container restarts. source
  • Pick a file storage location Set the storage provider in .env, such as Openlist, and fill in its base URL, root path, and token. If these are missing, ChronoFrame will not know where to put or find your media. source
  • Deployment Deploy with Docker and follow the built-in setup wizard; no separate database installation is needed. source

Fetched today - each note links to its source

Alternatives (8)

  • Ente Photos - Open-source, end-to-end encrypted backup and sharing for photos and videos, with multi-platform sync, original quality, privacy controls, a…
  • Google Photos - Cloud storage offering 15 GB free space, automatic album and duplicate organization, AI editing, cross-platform sharing, and secure backups.
  • Immich - Self-hosted solution enabling photo and video backup, privacy-driven local AI search, facial recognition, map-based tagging, and multi-user…
  • Iphotron
  • Nextcloud Photos - 📸 Your memories under your control.
  • PhotoPrism - PhotoPrism is a self-hosted, AI-powered photo and video manager.
  • Plex Photos - Plex Photos lets you effortlessly view and manage your personal photo libraries, providing easy access to your favorite moments both at hom…
  • foldergram - Foldergram is a self-hosted, local-first web gallery that scans folders for photos and videos and displays them in a fast, Instagram-style…

Checked today - source: AlternativeTo

Common questions

Where should I mount my data volume for Docker?

Mount ./data to /app/data. It holds the database, settings, session secret, and local photos when using local storage at /app/data/storage.

Which port does the web UI use?

The web UI uses port 3000. Open that port in your firewall if you will access the container over a network.

Do I need a .env file before starting?

Create a .env from .env.example before starting, with the admin account, secret settings, and storage provider details. Without it, the app may launch but you may not be able to sign in or store files.

Can I add map support later?

Yes, you can add a map token later and start uploading photos first.

How does duplicate detection work?

ChronoFrame uses content hashing, not filename matching. Two files are duplicates only if their bytes are identical, so changes in compression, metadata, or format prevent a match.

Answers sourced from github.com, github.com, github.com, github.com

Community

Collected today - public community threads