Skip to main content

πŸ“¦ unRAID

Community App​

We are now also a community app based on the singleton image.

Docker Compose​

You have to download docker-compose. You can add the following to your /boot/config/go file to make sure it's always available:

curl -L "$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Check if it's working:

docker-compose --version

You'll need to create a folder under /mnt/user (e.g. librephotos) within there you'll need two files:

mkdir /mnt/user/librephotos && cd /mnt/user/librephotos

Download this file and save it as .env:

wget -O .env

​Download this file to the same directory, but keep the original name:


You'll need to edit the .env file with paths to your photos (myPhotos) and possibly the timeZone variable. Optionally, you'll want to grab a mapbox API key as documented in the file. Keep note of the default HTTP port, 3000. You should have LibrePhotos accessible after a few minutes of boot-up on unraidip:3000 unless you changed this in the .env file. The username is admin & the password is admin, unless you changed them in the .env file. It is recommended you change the admin username and password if LibrePhotos is going to be publicly accessible. This is done via the .env file.

​Once done, you can fire up the containers by typing:

docker-compose up -d

This will cause the containers to startup in the background. You can check the status of them by running:

docker logs {container name}

You can get a name for each of the containers by typing:

docker ps | grep librephoto

Finally, you can access the UI by going to http://unraidip:3000

The first thing you'll want to do in the UI is go to the drop-down menu located at the top right under avatar and select Admin Area.

You'll need to set your "Scan Directory" which should be /data.

Go back to the drop-down and select Settings. Scroll to the bottom and select Scan photos from bottom left. You'll see some activity on your server as the photos are being processed. You can check on them by going to Photos on the top left of the UI and select recently added. ​

Furthermore, you can also monitor progress from shell prompt by tailing this file:

tail -f librephotos_logs/ownphotos.log

To shut everything down:

docker-compose down

If you want to grab any updates, you can type:

docker-compose pull

docker-compose issues when rebooting​

After a reboot, docker-compose is not installed anymore, since unRAID loads everything from ram. Someone created a Docker Compose Manager app in the Apps catalog for unRAID. This makes sure docker-compose is installed every time you reboot unRAID, and they are currently working on a Web GUI.

Thanks to u/Tusc00 and Martijn (Spiek90) for this write-up!

Next Steps​

Next, take a look at the [first steps after setup]({% post_url user_guide/0000-02-01-first_steps %}).