OpenSource-Hub
P

Photoview

6.4k stars·File Management·SHA-256 checksum verified

Simple and user‑friendly self‑hosted photo gallery for photographers. Automatically indexes directories, generates thumbnails, supports RAW and EXIF, and includes face recognition.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Self‑hosted photo gallery for photographers, with RAW support, face recognition, and easy Docker deployment.

Core Features

  • Closely tied to the filesystem: directories map directly to albums
  • User management: each user can be assigned a separate media path
  • Sharing: albums and individual media can be shared via public links with optional password protection
  • Supports RAW image formats and EXIF parsing
  • Video support: common formats automatically optimized for web playback

What It Can't Do

  • Docker registry has migrated; update image references in your compose file. PostgreSQL on the master branch has been updated to version 18 — back up your database before upgrading. Portainer and similar abstraction layers are not officially supported; please reproduce issues with plain Docker Compose.

Use Cases

  • Photographers managing and showcasing high‑resolution portfolios
  • Families building a private cloud photo album to replace Google Photos
  • Media enthusiasts organizing and sharing large collections of photos and videos by folder structure

Detailed Introduction

Photoview is a self‑hosted photo and video gallery designed specifically for photographers. It works by scanning a directory on your filesystem and presenting the media on a clean web interface, organised exactly as the folders on disk. Key strengths include raw support (CR2, NEF, ARW, etc.) and EXIF metadata parsing, automatic thumbnail generation for fast browsing, video transcoding for web playback, and built‑in face recognition that groups photos of the same person. User management allows each user to be assigned a separate media path, and albums or individual media can be shared publicly with optional password protection. Photoview can be deployed via Docker, Debian/Ubuntu, Arch, NixOS, Unraid, YunoHost, and TrueNAS. It supports SQLite, MariaDB, and PostgreSQL as the database backend. The project is actively maintained with a responsive community on Discord.

Troubleshooting & FAQ (1)

Troubleshooting
How to fix 'unsupported media type' error when adding CR3 files to Photoview?

Photoview currently does not display CR3 files. As a workaround, extract the embedded full-size JPEG using exiftool: exiftool -b -JpgFromRaw IMAGE.CR3 > IMAGE.JPG. Then add the resulting JPG to your library. A future update will automate this extraction natively.

GitHub Issue #1307

Tags

photo-galleryself-hostedphotographyrawexifface-recognitiondocker

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Ensure Docker and Docker Compose are installed

4

Step 2: Download the official docker-compose.example.yml and save as docker-compose.yml

5

Step 3: Edit environment variables to set admin password and media directory path

Install Guide
  1. Step 1: Ensure Docker and Docker Compose are installed
  2. Step 2: Download the official docker-compose.example.yml and save as docker-compose.yml
  3. Step 3: Edit environment variables to set admin password and media directory path
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

In the directory containing docker-compose.yml, run `docker compose down -v` to remove containers and volumes. For full cleanup, delete the persistent data directories manually.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseGPL-3.0
Last Updated2026-06-26 22:40:18
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects