Currently, the project is in very early stages; some bugs may exist. If you find any, please log an issue.
It kind of works on ARM processors. Due to limited ram & processing power it will not be as fast. ARM Development is still in progress expect bugs.
LibrePhotos will only work on ARM devices (e.g. Raspberry Pis) if they are running an ARM64 operating system.
Check what version you have by running
dpkg --print-architecture. If it says
arm64, you are good to go. Otherwise,
you need to install an ARM64 operating system on your device.
You will need at least 10 GB of storage space for the docker images. This space is mainly used by machine learning models. LibrePhotos will also create a database and thumbnails, which will need additional space.
LibrePhotos comes with separate backend and frontend servers. The backend serves the restful API, and the frontend serves, well, the frontend. They are connected via a proxy. The easiest way to do it is using Docker.
Docker-compose method (Recommended)
Clone the repo:
git clone https://github.com/LibrePhotos/librephotos-docker.git
cp librephotos.env .env
.env in your favorite text editor and make the required changes.
Do not forget to create the directories you specified in the
.env file if they do not exist.
docker-compose -f docker-compose.arm.yml up -d
If you do not follow the above command and use just
docker-compose up -d you are going to have a bad time
You should have librephotos accessible after a few minutes of boot-up on: localhost:3000 unless
you changed it in the .env file. User is admin, password is admin unless you changed it in the .env file. It is
recommended you change the admin username and password if Libre Photos is going to be publicly accessible via the
First steps after setting up
You need to log in as the admin user, and set up the directory for the users. To do this, click the top right button,
and go to
Admin Area. On this page, it will show a list of users. Manually set the
Scan Directory for the desired
user. Only an admin can do this. Then, go to
Library and click the green
Scan photos (file system)
button. If you have a Nextcloud instance, you can also input login details for it in the
Once logged in (the little circle next to
Nextcloud Scan Directory will be green), you can choose a top level
directory in your logged in Nextcloud account. Once this has been configured, you can click the blue
(Nextcloud) button. This will copy the contents of the specified Nextcloud directory to the local filesystem.
The basic idea is this:
- For scanning photos that reside in the local file system
- Only the admin user can change the “scan directory” of the users, including the admin itself.
- Normal users cannot change his/her own “scan directory”
- Only the admin can find the page to control this under the “user icon (top right) - admin area”
- For scanning photos that reside in external Nextcloud instances
- Any user can change their own Nextcloud endpoint, and choose a top level directory in the Nextcloud account.
- LibrePhotos is in development. Contributions are welcome!
- Join our Discord server or open a pull request to start contributing.