OpenSource-Hub
P

PiGallery2

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

A fast, directory-first photo gallery for low-resource servers (especially Raspberry Pi). Read-only, easy to deploy with Docker.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Ultra-lightweight, read-only photo gallery that mirrors your folder structure, perfect for Raspberry Pi.

Core Features

  • Blazing fast on low-end hardware (e.g., Raspberry Pi)
  • Directory-first: mirrors your exact folder structure
  • Read-only: never modifies original photo files
  • One-command Docker deployment

What It Can't Do

  • First load can take 30-60s due to server booting.
  • No editing/deletion of photos (read-only design).
  • Native installation is unsupported; always use Docker.
  • Large photo sets may cause slow initial indexing (cached afterward).

Use Cases

  • Home media server for family photo sharing
  • Raspberry Pi NAS with built-in gallery
  • Personal backup viewer that keeps originals untouched

Detailed Introduction

PiGallery2 is a self-hosted photo gallery website designed for speed and simplicity. It reads your existing folder structure and displays photos without modifying the original files. Optimized for low-end hardware like Raspberry Pi, it loads quickly even on limited resources. The recommended way to run it is via a single Docker command, making installation effortless. Features include directory-first navigation, full read-only mode, and a clean web interface. Perfect for home media servers, personal archives, or lightweight cloud galleries. It supports all common image formats and offers basic sharing/user rights management.

Troubleshooting & FAQ (1)

Troubleshooting
How to fix FFmpeg error: 'Option hwaccel cannot be applied to output url' when enabling VAAPI hardware acceleration?

This error occurs when hardware acceleration options like -hwaccel vaapi are placed after the output file. Ensure all hwaccel options come before the input file (-i). Example command: ffmpeg -hwaccel vaapi -hwaccel_output_format vaapi -vaapi_device /dev/dri/renderD128 -i input.mp4 ...

GitHub Issue #592

Tags

photo-galleryself-hostedlightweightdockerraspberry-piopen-source

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: Install Docker on your server

4

Step 2: Run: docker run -p 80:80 -v /path/to/photos:/app/data/images -v pigallery2-config:/app/data/config bpatrik/pigallery2

5

Step 3: Open http://localhost in your browser

Install Guide
  1. Step 1: Install Docker on your server
  2. Step 2: Run: docker run -p 80:80 -v /path/to/photos:/app/data/images -v pigallery2-config:/app/data/config bpatrik/pigallery2
  3. Step 3: Open http://localhost in your browser
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

Stop container: docker stop <container>; Remove container: docker rm <container>; Remove image: docker rmi bpatrik/pigallery2; Remove config volume: docker volume rm pigallery2-config (note: original photos remain untouched).

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-06-27 07:35:40
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects