PiGallery2-Plus

PiGallery2-Plus

Docker app from Railloune's Repository

Overview

PiGallery2 Plus is a performance and metadata focused fork of PiGallery2 for large self-hosted photo and video archives. It keeps the fast directory-first gallery experience while adding smoother infinite browsing, richer Gallery Grabber metadata display, share-link and random-link improvements, activity audit logs, public direct image links, safer video fallback handling, and a more ergonomic lightbox player. Mount your media library read-only for safer public exposure.

PiGallery2 Plus

PiGallery2 Plus is a performance and metadata focused fork of PiGallery2 for large self-hosted media archives.

It keeps the original directory-first gallery model and adds features aimed at large libraries, richer metadata, public sharing, and smoother browsing.

Highlights

  • Fast large-gallery browsing with incremental loading improvements.
  • Rich metadata display for archive workflows, including source site, source URL, preserved filename, creator, and private-gallery markers.
  • Share-link fixes for guest and limited guest browsing.
  • Public random-image URLs that can be constrained by a share key and search query.
  • Editable random-link queries for admins and link owners.
  • Activity audit logs for logins, user actions, share-link use, and admin views.
  • Browser-native MP4/WebM/OGV playback stays direct, with ffmpeg fallback handling for formats that need conversion.
  • Lightbox video controls with 5 second keyboard seeking and finer volume handling.

Recommended Unraid Setup

Keep your media mount read-only unless you specifically need PiGallery2 Plus to write to your archive.

Suggested mappings:

/app/data/config -> /mnt/user/appdata/pigallery2plus/config
/app/data/db     -> /mnt/user/appdata/pigallery2plus/db
/app/data/tmp    -> /mnt/user/appdata/pigallery2plus/tmp
/app/data/images -> your media library, mounted read-only

For best performance, place config, db, and tmp on cache/SSD-backed appdata.

First Start

Open the WebUI after the container starts and complete the PiGallery2 setup.

If you expose the gallery through a reverse proxy, set the template's Public URL advanced variable to the public HTTPS URL so generated share links and random-image URLs are correct.

Docker Image

railline/pigallery2plus:latest

Versioned tags are also available, for example:

railline/pigallery2plus:3.6.0-plus.8

Support

Install PiGallery2-Plus on Unraid in a few clicks.

Find PiGallery2-Plus in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for PiGallery2-Plus Review the template variables and paths Click Install

Download Statistics

272
Total Downloads

Related apps

Explore more like this

Explore all

Details

Repository
railline/pigallery2plus:latest
Last Updated2026-06-13
First Seen2026-06-13

Runtime arguments

Web UI
http://[IP]:[PORT:80]
Network
bridge
Shell
sh
Privileged
false
Extra Params
--security-opt=no-new-privileges:true

Template configuration

WebUI - HTTP host portPorttcp

Host port for the PiGallery2 Plus web interface.

Target
80
Default
8089
Value
8089
Paths - ConfigPathrw

Persistent PiGallery2 Plus configuration, including config.json and extension configuration.

Target
/app/data/config
Default
/mnt/user/appdata/pigallery2plus/config
Value
/mnt/user/appdata/pigallery2plus/config
Paths - DatabasePathrw

Persistent database folder for PiGallery2 Plus index data, job history, share links and audit data.

Target
/app/data/db
Default
/mnt/user/appdata/pigallery2plus/db
Value
/mnt/user/appdata/pigallery2plus/db
Paths - Temp and cachePathrw

Temporary files, thumbnails, transcoding cache and generated assets. Put this on SSD/cache for best performance.

Target
/app/data/tmp
Default
/mnt/user/appdata/pigallery2plus/tmp
Value
/mnt/user/appdata/pigallery2plus/tmp
Paths - Media libraryPathro

Your photo and video archive. The default mapping is read-only and recommended for public galleries.

Target
/app/data/images
Default
/mnt/user/photos
Value
/mnt/user/photos
Core - TZVariable

Timezone used by the container.

Target
TZ
Default
Europe/Paris
Value
Europe/Paris
Core - NODE_ENVVariable

Runtime mode. Use production for normal deployments; debug is only for troubleshooting.

Target
NODE_ENV
Default
production
Value
production
Sharp Input Pixel LimitVariable

Maximum source pixel count accepted by Sharp for thumbnails. 268435456 is about 16384x16384 and avoids Input image exceeds pixel limit errors on large GIF/images.

Target
PIGALLERY_SHARP_LIMIT_INPUT_PIXELS
Default
268435456
Value
268435456
Public URLVariable

Optional public base URL, for example https://gallery.example.com. Set this when generating share links or random-image URLs behind a reverse proxy.

Target
default-Server-publicUrl