# 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 metadata, location maps, albums, and live photos.

Canonical page: https://ourlocalhost.com/app/8028/chronoframe

## Description

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: Any server.

## Health score

78/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 66 (1,986 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://docs.chronoframe.art/
- GitHub: https://github.com/HoshinoSuzumi/chronoframe
- Documentation: https://docs.chronoframe.art/

## 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.

## Alternatives

- 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…

---
Source: Our Local Host (https://ourlocalhost.com/app/8028/chronoframe), the self-hosted and open-source app directory.
