Self-Hosted / Projects / PhotoPrism
PhotoPrism
StableSpecs verified September 23, 2026 · against v260919-28c46a116
Overview
Self-hosted Google Photos alternative for private photo and video organization.
PhotoPrism is a self-hosted Google Photos alternative for browsing, organizing, searching, and sharing photo and video libraries on infrastructure you control.
Why people choose it
PhotoPrism focuses on making a large personal media library searchable and manageable without handing the original files to a cloud photo provider. Official product materials highlight search filters, maps, face recognition, automatic classification, RAW and video handling, and a privacy-first deployment model.
What is included
The web application indexes photos and videos, generates thumbnails and sidecars, extracts metadata, supports search and map views, and can recognize faces and classify content. It handles common image, video, and RAW formats, with FFmpeg and ExifTool playing important roles in video and metadata workflows.
Deployment requirements
The recommended private-server path is Docker Compose on a 64-bit operating system. Official setup guidance lists at least 2 CPU cores and 3 GB physical memory, recommends at least 4 GB swap, and notes that large libraries, RAW files, and high-resolution panoramas can need more memory and local SSD storage. Plan storage and backups for originals, the database, and generated storage data separately.
Main tradeoffs
PhotoPrism is more operationally involved than a hosted photo service. Indexing can be resource-intensive, some features depend on the configured stack, and a database backup alone is not a backup of the original media. Test restore procedures and keep the originals protected outside the application container.
Best fit
Choose PhotoPrism if you want a privacy-focused, searchable photo archive and are comfortable operating Docker, storage, indexing, and backups. A simpler gallery may be a better fit if you only need basic browsing with minimal indexing.
Interface previews
Screenshots of the PhotoPrism interface.
Feature support
| Feature | Support |
|---|---|
| Photo and video library browsingThe official product site positions PhotoPrism around browsing, organizing, and sharing photos and videos. | Supported |
| Search filters and metadata-based discoveryOfficial product materials describe powerful search filters and metadata-driven discovery. | Supported |
| Face recognition and content classificationThe official product page highlights face recognition and automatic content/location classification; indexing resources vary by library. | Supported |
| Maps and location browsingThe official product page includes high-resolution world maps for location-based browsing. | Supported |
| RAW, HEIC, video, and common media formatsThe FAQ lists broad format support, while video indexing and RAW conversion depend on FFmpeg, ExifTool, and available resources. | Partial support |
| Docker Compose deploymentOfficial docs recommend Docker Compose for private servers and publish multi-architecture compose examples. | Supported |
| Mobile photo backupMobile upload workflows can be added, but PhotoPrism is primarily the library and indexing server; client and backup design still need to be planned. | Partial support |
Community signals
- Stars
- 40.3k
- Forks
- 2.3k
- Open issues
- 464
- Last commit
- 15h ago
- Latest release
- 261007-65faaae5d
- Repo created
- Jan 2018
Includes open pull requests
1w ago
Refreshed nightly from the GitHub API.
Questions
What is PhotoPrism used for?
PhotoPrism is used to self-host a searchable photo and video library with browsing, metadata, maps, face recognition, and sharing features.
Is PhotoPrism a self-hosted Google Photos alternative?
Yes. It is a self-hosted alternative for people who want Google Photos-style organization and search while keeping the library on their own infrastructure.
How much hardware does PhotoPrism need?
Official setup guidance recommends at least 2 CPU cores, 3 GB physical memory, a 64-bit operating system, and at least 4 GB swap. Large libraries, RAW files, and high-resolution panoramas can need more.
Does PhotoPrism require Docker?
No, but Docker Compose is the recommended private-server deployment path. Official docs also cover Podman, NAS devices, Raspberry Pi, and manual packages for compatible systems.
Does PhotoPrism support RAW and video files?
Yes, with caveats. The official FAQ lists common image, video, and RAW formats. Video indexing and RAW conversion rely on components such as FFmpeg and ExifTool and can increase resource use.
Does a PhotoPrism database backup protect my photos?
No. The original media files need their own backup plan. Protect the originals, database, and generated storage data, and test that a restore works before treating the deployment as safe.
support // the lab
Found this write-up useful?
If it saved you time or a rebuild, you can support more practical homelab guides.