pigallery2

A fast directory-first photo gallery website, with rich UI, optimized for running on low resource servers (especially on raspberry pi)

Automatically checked · GitHub checked 2026-11-16

pigallery2

Overview

PiGallery2

GitHub package.json version Coverage Status CI Sponsor Ko-fi

PiGallery2 is a fast directory-first photo gallery website, optimized for running on low-resource servers (especially on Raspberry Pi).

🚀 Key Features

  • ⚡ Fast: Optimized for low-end hardware.
  • ✔️ Simple: Point to your photos and you are ready.
  • 📁 Directory-first: Shows your folder structure as it is.
  • Read-only: Your photo folder is never modified.

Full documentation here.

Try our live demo! (First load may take up to 60s while the server boots up)

🏁 Getting Started

The official and recommended way to run PiGallery2 is using Docker.

Install with Docker (Recommended)

Native Installation (Unsupported)

Native installation is possible for users familiar with Node.js but is not officially supported.

📖 Documentation

For more detailed information, please see our Documentation Website or the docs/ folder:

📱 Apps & 3rd party tools

  • Install it as an app: PiGallery2 is a PWA, so you can install it on your phone as it is (browser menu -> Add to Home screen).
  • Extensions: community extensions that you can install from the settings page.
  • Native Android app: a community-made Android (and Android TV) client.

3rd party tools are not maintained by me, and I take no responsibility for them. More details.

🤝 Contributing

Bug fixes are welcome! I mostly merge bug fixes: to keep the app simple, new features should be a setting, a theme or an extension when possible. Please read the Contribution Guide before you start. Using an AI coding agent? See AGENTS.md.

❤️ Support

PiGallery2 is free, and I build it alone in my free time, which, since my daughter was born, mostly means nap time 👶. WebStorm and AI coding agents help me make the most of those short windows.

If PiGallery2 makes your photos a bit nicer to browse, consider sponsoring me on GitHub or buying me a coffee on Ko-fi. A coffee is plenty, and pizza or a date night with my wife is even better 🍕.

⭐ Star History

Star History Chart

📜 License

PiGallery2 is licensed under the MIT License.