Table of Contents

Damselfly

Note: since i don't use this service anymore, this page might be not updated.

Damselfly is a digital asset management tool to manage huge collections of photos. Still testing, i love the concept.

Installation

Installing Damselfly can be done on bare-metal, but the dev does not support it, so i will show you both ways.

In general you can find more installation information here.

Common installation steps

Create a damselfly user and make it member of the photos group:

groupadd photos
useradd -d /data/daemons/damselfly -m -g photos damselfly

Since Damselfly uses INotify triggers, you need to increase defaults or it will be unable to monitor large collections of photos (see here).

Create the file /etc/sysctl.d/damselfly.conf:

fs.inotify.max_user_instances=524288

And for it to be applied without a reboot:

 sysctl -p /etc/sysctl.d/damselfly.conf

Bare Metal Installation (not recomended)

Non-containerized install instructions here

Download and decompress the release:

su - damselfly
wget https://github.com/Webreaper/Damselfly/releases/download/4.1.0/damselfly-server-linux-4.1.0.zip
mkdir damselfly
cd damselfly
unzip damselfly-server-linux-4.1.0.zip

(the release zip file requires a sub-folder to store neatly all files)

In order for Damselfly to work you need to install some dependencies, which can be found in the Docker file.

There you go:

emerge -s media-fonts/liberation-fonts dev-dotnet/libgdiplus media-gfx/dcraw media-libs/exiftool

The supposed libgmp1 dependency is satisfied by adding openmp useflag to GCC (see here) which should be enabled by default in Gentoo.

Podman installation

Create the following docker-compose.yml:

docker-compose.yml
version: "3.8"

name: damselfly
    
services:
  damselfly: 
    container_name: damselfly
    image: webreaper/damselfly
    ports:
      - 6363:6363/tcp
    volumes:
      - /data/daemons/damselfly/config:/config
      - /data/daemons/damselfly/thumbs:/thumbs
      - /data/Photos:/pictures 
    restart: unless-stopped

networks:
  damselfly-net: {}

And install it:

su - damselfly
podman compose pull

Reverse Proxy

Damselfly do not support sub-paths, so you must spin your own subdomain for it to work. Here is the relevant NGINX configuration file:

damselfly.conf
TBD

Startup

Bare Metal running

Start:

./Damselfly.Web /path/to/my/photos

You will need the usual script & /etc/local.d/damselfly.start script for automatic start on boot.

Podman running

Running is, as usual:

su - damselfly
podman compose up

To run at boot, add the following lines to your /etc/local.d/80-containers.start:

podman network create damselfly-net
su - damselfly -c "podman compose up -d"

and the following lines to /etc/local.d/80-containers.stop:

su - damselfly -c "podman compose down"