Open source face recognition for your family photos

NOTE: I have currently problems to compile DLIB. My base system does not allow to compile DLIB due to version problems. Therefore I cannot update the Nextcloud docker for face recognition.

Do you like face recognition for your family pictures? Me, too. But I figured out, that I spend too much time with the administration, especially with migrating it from laptop to laptop. And since I have multiple computers, mixed Microsoft, Linux and Mac, I got tired of the silos. Initially, I used MacOS Aperture then Photos and and and …

Every time I have tagged the pictures properly, I got a new computer, my wife couldn’t access the photos on her laptop and was always complaining about that. So I decided to move all photos to my nextcloud server. I run Nextcloud on a Intel Nuc at home, using Linux (Openmediavault) and heavily Docker. I can access it from anywhere in the world, thanks to Duckdns.

Since no nextcloud docker image had the requirements installed I needed for the face recognition app in nextcloud, I decided to make a docker image by myself and published it on Docker Hub. Feel free to use it. I will maintain it try to enhance it step by step


17 responses to “Open source face recognition for your family photos”

  1. Not really, to be honest.

    So, in general the Apache Image works in your local network, right?

    But it does not work behind your Nginx Reverse proxy? Did you check all the log files to get an idea where the problem might be?

  2. Unfortunately this is an x64 container. I do not support ARM architectures, which includes Raspberry PI. I am also wondering if an RPI is capable to handle the AI face detection, that takes a lot of CPU/GPU power. A jetson nano would probably be the better solution for something like that.

  3. Hello

    I’m new for portainer/docker. I have install as per instructions on with Base version – apache and change to use this image (iamklaus/nextcloud). but cannot run and found error

    exec / exec format error

    i don’t know how to fix this error, Could you help me to fix it?

    Raspberry Pi4
    OS: raspbian 64 bit


  4. Hi Klaus,
    I’m using nextcloud with portainer on my OMV NAS. All is working fine.
    I use the Apache Image behind my Ngynx Proxy Manager. But when i try to use your Image, it doesnt work with my settings.
    Any tip?

  5. Hi Oleg,
    it is super easy. Which version are you using from nextcloud? FPM or apache? And: Are you using portainer to manage your docker instances?

  6. Hi Klaus! First of all thanks for your work, it’s awesome when someone shares his work!
    I have a question about migrating from official Nextcloud docker to your image. Can you please describe how that can be done without losing all the settings, users and etc? Of course it’s best to start from fresh, but it’s just too much things I’ve set up already, but I really need face recognition, and the tutorial to add it is just too long and quite hard for me to follow and understand. Thanks a bunch!

  7. Hi Klaus,

    I managed to build a working Docker for my Raspi.

    However, I had hard time to properly configure it, that is selecting the FaceReco models to use…and various other configs. See `occ` commands here

    Do you have a recommendation on how to do it ?
    Moreover, I’d like to store the data on a different location, typically to a drive connected via USB 3. I’m having the Argon One M.2 setting (
    Do I have to change that in the Docker file or in CLI when starting the docker image ? Sorry if this is a basic `docker question`.

    Anyways, I went back to a basic manual installation to test that every thing works (pictures loaded from family smartphones). It worked pretty well, and the models were able to execute on a collection of over 1000 images in just a couple of hours on the Raspi.

    I went for MariaDB, and it was so satisfying to see all the FaceReco data written in the tables (including the descriptors) in the DB. Do you know if there’s documentation for the DB model. I would like to query specific photos, for example photos where the kids (son & daughter) are in…etc

    Happy holidays and cheers,


Leave a Reply

Your email address will not be published. Required fields are marked *

The maximum upload file size: 128 MB. You can upload: image, audio, video, document, archive, other. Links to YouTube, Facebook, Twitter and other services inserted in the comment text will be automatically embedded. Drop files here