A directory-first photo gallery website, with a rich UI, optimised for running on low resource servers.
Deploy this app to Linode with a free $100 credit!
Homepage: http://bpatrik.github.io/pigallery2/
This is a fast (like faster than your PC fast) directory-first photo gallery website, optimised for running on low resource servers (especially on raspberry pi).
✔️ Strengths: * ⚡ Fast, like for real. * ✔️ Simple. Point to your photos folder and to a temp folder and you are good to go.
⛔ Weakness: * 😥 Its simple. Shows what you have that's it. No gallery changes (photo delete, rotate, enhance, tag, organize, etc), your gallery folder is read-only. * 📁 Optimized for galleries with <100K photos with <5k photos/folder. * It will work on bigger galleries, but it will start to slow down.
Live Demo @ render: https://pigallery2.onrender.com/ - the demo page first load might take up 30s: the time while the free webservice boots up
Docker with docker-compose is the official and recommend way of installing and running Pigallery2. It contains all necessary dependencies, auto restarts on reboot, supports https, easy to upgrade to newer versions. For configuration and docker-compose files read more here or check all builds here.
As an alternative, you can also directly install Node.js and the app and run it natively.
Download and extract
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs
Full node install on raspberry pi description: https://www.w3schools.com/nodejs/nodejs_raspberrypi.asp
cd ~
wget https://github.com/bpatrik/pigallery2/releases/download/1.9.0/pigallery2-release.zip
unzip pigallery2-release.zip -d pigallery2
cd pigallery2
npm install
Note: A build requires a machine with around 2GB or memory.
cd ~
wget https://github.com/bpatrik/pigallery2/archive/master.zip
unzip master.zip
cd pigallery2-master # enter the unzipped directory
npm install
npm run build
Note: It is recommended to create a release version with npm run create-release
on a more powerful machine and deploy that to you server.
Note: you can use npm run create-release -- --languages=fr,ro
to restrict building to the listed languages (English is added by default)
npm start
To configure it, run PiGallery2
first to create config.json
file, then edit it and restart.
The app has a nice UI for settings, you may use that too.
Default user: admin
pass: admin
. (It is not possible to change the admin password, you need to create another user and delete the default admin
user, see #220)
Note: First run, you might have file access issues and port 80 issue, see #115.
Running npm start -- --Server-port=8080
will start the app on port 8080 that does not require root
Adding read/write permissions to all files can solve the file access issue chmod -R o-w .
, see #98.
You can run the app up as a service to run it on startup. Read more at #42
You can set up the app any of the following ways:
1. Using the UI (recommended)
2. Manually editing the config.json
3. Through switches
* Like: node start -- --Server-port=3000 --Client-authenticationRequired=false
* You can check the generated config.json
for the config hierarchy
4. Through environmental variable
* like set env. variable Server-port
to 3000
Full list of configuration options are available at the MANPAGE.md.
It is recommended to use a reverse proxy like nginx before node https://stackoverflow.com/questions/5009324/node-js-nginx-what-now
With cerbot & nginx it is simple to set up secure connection. You have no excuse not doing so. https://certbot.eff.org/
If you get error during module installation, make sure you have everything to build node modules from source
apt-get install build-essential libkrb5-dev gcc g++
src/frontend/translate/messages.en.xls
to src/frontend/translate/messages.fr.xls
angular.json
projects->pigallery2->i18n->locales
section <target>
tagsnpm install
npm run build
npm start
Note: you can also build your own release with as described in 1.1.1-b Install from source;
*.mp4
files and partially (might have errors with safari and IE) supports *.ogg
, *.ogv
, *.webm
files.pg2conf
UI modifying files. #177.In progress
Unfortunately, lately I only have a limited time for this hobby project of mine.
So, I mostly focus on those features that are align with my needs. Sorry :(.
Although, I try to fix bugs ASAP (that can still take from a few days to months).
I also try to implement some feature requests that have a lots of 'likes' (i.e.: +1
-s or thumbs ups) on it.
If you have a feature that you really would like to happen, I welcome contributions to the app. See CONTRIBUTING.md for more details.
I'm making this app for my own entertainment, but I like to share it with others as the contributions and bug reports make the app better and it also does not cost anything to me :)
There is no way to donate to this project at the moment. And I'm also not planning on monetizing it. But it warms my hearth seeing that it is useful for some people.
Crossbrowser testing sponsored by Browser Stack
Please login to review this project.
No reviews for this project yet.
Self-hosted open-source web gallery to browse personal phot…
Self-hosted Google Photos alternative, with a very similar …
Gallery.css is all CSS. Think: Simple, maintainable and und…
Comments (0)
Please login to join the discussion on this project.