Skip to main content

🐋 Docker

Docker Compose​

We recommend you use docker compose as this matches the demo and development environment the most.

Compatibility​

You need an x86 or ARM64 processor, and it is recommended to have 4GBs of RAM. Due to limited memory & processing power, ARM64 will not be as fast.

Size​

You will need at least 10 GB of HDD Space for the docker images. It needs that space because of the machine learning models. Librephotos will also create a database and thumbnails, which will need additional space.

🚀 Installation​

Clone the repo: git clone https://github.com/LibrePhotos/librephotos-docker.git

Navigate to the librephotos-docker folder: cd librephotos-docker

Copy the template variable file (containing options such as the location of your photos): cp librephotos.env .env

Open .env in your favorite text editor and make the required changes. E.g., using nano: nano .env

Do not forget to create the directories you specified in the .env file if they do not exist.

Start LibrePhotos with docker-compose up -d

You should have LibrePhotos accessible after a few minutes of boot-up on localhost:3000

Next Steps​

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

Updating​

To update LibrePhotos when using Docker Compose, navigate to the librephotos-docker folder that was created when you installed LibrePhotos.

Then run:

docker-compose down
docker-compose pull
docker-compose up -d

Docker​

Overview of the folders that can be mounted as volumes:

  • /var/lib/librephotos/photos/ your actual photos
  • /var/lib/librephotos/data/protected_media/ thumbnails
  • /var/log/librephotos/ logs
  • /var/lib/postgresql/data/ database

Replace the first part that is in brackets with the actual location of the folder:

sudo docker run -v <photos>:/var/lib/librephotos/photos/ -v <thumbnails>:/var/lib/librephotos/data/protected_media -v <logs>:/var/log/librephotos/ -v <db>:/var/lib/postgresql/data -p 3000:80 -d reallibrephotos/singleton

If you run into any permission issue, add -e FIXPERMISSIONS=true or change the permission to allow read/write/execute your photo folder to other users.