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…
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
Variants
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
- Show HN: ChronoFrame – A self-hosted personal photo gallery app (forum)
- Show HN: ChronoFrame – Online photo gallery with smart EXIF, maps and live-photo (forum)
- ChronoFrame – A slick, online photo gallery with smart EXIF, maps and live-photo (forum)
- Reddit (reddit)
- ChronoFrame: A Self-Hosted Photo Gallery App with Use Management Tools (forum)
Collected today - public community threads