Freedom251 › Photo Management Software
PiGallery2

What PiGallery2 is
PiGallery2 is a self-hosted photo gallery website for low-resource servers, including Raspberry Pi, designed for people who want to retain their existing folder organization. It displays photos in a grid with recursive folder browsing and renders images as visitors scroll. Search supports boolean logic, negation, exact and wildcard matches, and autocomplete; saved searches provide an alternative to database-only albums. The viewer offers full-screen display, keyboard navigation, slideshows, and an optional information panel. Folders can be shared through links that may be password protected. The gallery can show photo locations on OpenStreetMap or Mapbox and display routes from GPX files. Supported media include JPG, WebP, PNG, GIF, MP4, OGG, OGV, and WebM. Files on disk remain the source of truth, while the database is a rebuildable cache, and the project says it does not modify the photo folder. PiGallery2 is MIT-licensed and free. Docker with Docker Compose is the recommended installation method; native installation is possible for Node.js users but is not officially supported. The hobby project has no fixed release schedule, and database or configuration changes may require resets between releases.
Who it suits
It suits people with organized photo folders who want to host and share a gallery on a low-resource server without uploading photos to a third-party service.
What it does well
- Keeps the existing folder structure as the basis for browsing.
- Search supports boolean logic and wildcards.
- Folder links may be password protected.
- Supports image and video formats.
- MIT-licensed and free.
What to know first
- Native installation is not officially supported.
- arm32v7 Docker images are deprecated.
- No database upgrade scripts are provided.
- Releases do not follow a fixed schedule.
Limits
The free plan is the self-hosted photo gallery. Database or configuration changes may require resets between releases, and native installation is not officially supported.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| PiGallery2 | Self-hosted photo gallery · MIT-licensed | Free |
As bpatrik.github.io lists them, read 8 Oct 2026. The maker's own page has the final word.
Getting started
- Visit the PiGallery2 website.
- Prepare a self-hosted Linux or other supported server environment.
- Install with Docker and Docker Compose, the recommended route.
- Choose an available Docker image architecture: amd64 or arm64v8.
- Configure authentication if needed, then organize and share folders.
Verdict
PiGallery2 is a free, self-hosted gallery centered on existing folders, with search, sharing, and map features. Be prepared to manage deployment and possible resets when database or configuration changes are needed.
Questions
How much does PiGallery2 cost?
The PiGallery2 plan is free. It is also described as free and MIT-licensed.
Is there a free trial?
No. PiGallery2 is free, and no free trial is offered.
Where can I run PiGallery2?
Its platforms include Linux, self-hosted, and web. Docker images are listed for amd64 and arm64v8; arm32v7 is deprecated.
What media formats does it support?
Supported formats include JPG, WebP, PNG, GIF, MP4, OGG, OGV, and WebM.
Is PiGallery2 open source?
Yes. The project is licensed under the MIT License.
How can I install it?
Docker with Docker Compose is the recommended installation method. Native installation is possible for people familiar with Node.js, but is not officially supported.
Facts from PiGallery2's own pages
- Authentication
- Available authentication options include no authentication, built-in basic authentication, and ORCID support. · bpatrik.github.io, 8 Oct 2026
- Data model
- The project treats files on disk as the source of truth and the database as a rebuildable cache; it uses saved searches instead of traditional database-only albums. · bpatrik.github.io, 7 Oct 2026
- Deployment
- Docker with Docker Compose is the official recommended installation method; native installation is possible but unsupported. · bpatrik.github.io, 8 Oct 2026
- Extensions
- Users can build extensions, with support mainly for server-side changes and minimal UI modifications. · bpatrik.github.io, 7 Oct 2026
- Extensions and integrations
- It supports user-built extensions, Adobe XMP face-region metadata, ORCID authentication, and random-photo links for third-party applications. · bpatrik.github.io, 8 Oct 2026
- Formats
- The documented formats include JPG, WebP, PNG, GIF, SVG, selected camera RAW formats depending on the Docker image, and MP4, OGG, OGV, and WebM video. · bpatrik.github.io, 8 Oct 2026
- Integrations
- The gallery supports OpenStreetMap, Mapbox, custom map tile providers, and OpenID Connect with Authentik. · bpatrik.github.io, 7 Oct 2026
- Intended audience
- The project is intended for people who want to run a photo gallery on their own low-resource server while keeping their existing folder organization. · bpatrik.github.io, 7 Oct 2026
- Intended users
- The maker describes the project as useful for people with organized photo collections who want to share them without uploading them to a third-party service. · bpatrik.github.io, 8 Oct 2026
- License
- The project is licensed under the MIT License. · github.com, 7 Oct 2026
- Maps
- It plots photo location data on OpenStreetMap or Mapbox, supports custom map providers, and can display GPX tracks. · bpatrik.github.io, 8 Oct 2026
- Native installation
- Native installation is possible for users familiar with Node.js, but is not officially supported. · github.com, 7 Oct 2026
- Notable limitations
- The project does not provide database upgrade scripts, and database or configuration changes may require resets between releases. · bpatrik.github.io, 8 Oct 2026
- Photo browsing
- It displays photos in a grid with recursive folder listings and on-demand rendering as users scroll. · bpatrik.github.io, 7 Oct 2026
- Photo viewing
- Its photo viewer has an optional information panel, full-screen viewing, keyboard navigation, and slideshow support. · bpatrik.github.io, 8 Oct 2026
- Privacy and storage
- The project describes the disk as the source of truth and the database as a rebuildable cache; its README says the photo folder is never modified. · bpatrik.github.io, 8 Oct 2026
- Purpose
- PiGallery2 is a directory-first photo gallery website designed for low-resource servers, including Raspberry Pi. · bpatrik.github.io, 8 Oct 2026
- Release cadence
- The developer describes PiGallery2 as a hobby project, with releases when features are ready and time permits rather than on a fixed schedule. · bpatrik.github.io, 7 Oct 2026
- Search
- Search supports boolean expressions, negation, exact and wildcard matches, autocomplete, and metadata filters. · bpatrik.github.io, 8 Oct 2026
- Sharing
- Users can share photo folders through links that may be password protected. · bpatrik.github.io, 8 Oct 2026
- Support and releases
- The developer describes PiGallery2 as a hobby project maintained in free time, with releases when features are ready rather than on a fixed schedule. · bpatrik.github.io, 8 Oct 2026
- Supported architectures
- The Docker instructions list amd64, arm64v8, and deprecated arm32v7 architectures. · bpatrik.github.io, 8 Oct 2026
Where PiGallery2 stands on Freedom251
- Photo Management Software#22 of 37