Repolode
Submit
bpatrik

bpatrik/pigallery2

A fast, directory-first photo gallery website that shows your folder structure as-is, designed for low-resource servers such as Raspberry Pi.

View on GitHubWebsite
Stars
2,306
Forks
269
Open issues
157
Last commit
21 hours ago

What is it?

PiGallery2 is a self-hosted photo gallery website that displays photos the way they are organized on disk. Instead of building its own album model, it shows your existing folder structure, so pointing it at a photo directory is enough to start browsing.

The project is built with Node.js and an Angular front end, and it is tuned to run on low-end hardware, including Raspberry Pi. It is read-only: the photo folder is never modified. The recommended way to deploy it is with Docker, and a native Node.js installation is possible but not officially supported.

The project is written in TypeScript and released under the MIT license. It has a documentation site covering setup, configuration, user rights and contribution guidelines.

Key features

  • 01Shows photos using the existing folder structure without importing them into a database-driven album system.
  • 02Optimized for low-end hardware such as Raspberry Pi.
  • 03Read-only access, so the original photo folder is never changed.
  • 04Recommended deployment via Docker, with native Node.js installation also possible.
  • 05Configurable user rights and a documented configuration guide.

Use cases

  • Hosting a personal photo archive on a Raspberry Pi or other small home server.
  • Browsing an existing photo library by folder without reorganizing files.
  • Sharing a read-only photo gallery with family members on a local network.

Quick start

  1. 1

    Install with Docker (recommended) by following the official Docker setup guide linked in the README

  2. 2

    Native installation is possible but unsupported; follow the direct-install guide linked in the README

Things to know

  • Native installation is not officially supported; Docker is the recommended route.
  • Designed for low-resource servers, so it is not aimed at heavy photo-management workflows.

In collections

Self-hosted apps

Topics

#photo-gallery#self-hosted#raspberry-pi#nodejs#angular#typescript#docker#angular2#gallery#heroku

FAQ

What is pigallery2?
A fast, directory-first photo gallery website that shows your folder structure as-is, designed for low-resource servers such as Raspberry Pi. PiGallery2 is a self-hosted photo gallery website that displays photos the way they are organized on disk. Instead of building its own album model, it shows your existing folder structure, so pointing it at a photo directory is enough to start browsing.
Is pigallery2 free to use? What license does it have?
pigallery2 is open source under the MIT license. Check the license terms before using it in commercial products.
Is pigallery2 still maintained?
Actively maintained. The last commit to pigallery2 was on Oct 24, 2026.
What can I use pigallery2 for?
Hosting a personal photo archive on a Raspberry Pi or other small home server. Browsing an existing photo library by folder without reorganizing files. Sharing a read-only photo gallery with family members on a local network.
How do I install pigallery2?
Install with Docker (recommended) by following the official Docker setup guide linked in the README Native installation is possible but unsupported; follow the direct-install guide linked in the README
Where can I get pigallery2?
The source code and installation instructions are on GitHub: https://github.com/bpatrik/pigallery2

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects