User Tools

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
services:damselfly [2024/04/02 14:16] – willyservices:damselfly [Unknown date] (current) – removed - external edit (Unknown date) 127.0.0.1
Line 1: Line 1:
-====== Damselfly ====== 
- 
-**Note:** since i don't use this service anymore, this page might be not updated. 
- 
-[[https://damselfly.info|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 [[https://github.com/Webreaper/Damselfly/blob/master/docs/Installation.md|here]]. 
- 
-==== Common installation steps ==== 
- 
-Create a damselfly user and make it member of the //photos// group: 
-<code bash> 
-groupadd photos 
-useradd -d /data/daemons/damselfly -m -g photos damselfly 
-</code> 
- 
-Since Damselfly uses INotify triggers, you need to increase defaults or it will be unable to monitor large collections of photos (see [[https://github.com/Webreaper/Damselfly/blob/master/docs/Installation.md#filewatcher-inotify-limits|here]]).  
- 
-Create the file **/etc/sysctl.d/damselfly.conf**: 
-<file damselfy.conf> 
-fs.inotify.max_user_instances=524288 
-</file> 
- 
-And for it to be applied without a reboot: 
-<code bash> 
- sysctl -p /etc/sysctl.d/damselfly.conf 
-</code> 
- 
- 
-==== Bare Metal Installation (not recomended) ==== 
- 
-Non-containerized install instructions [[https://github.com/Webreaper/Damselfly/blob/master/docs/Installation.md#can-i-run-damselfly-without-docker|here]] 
- 
-Download and decompress the release: 
-<code bash> 
-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 
-</code> 
-(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 [[https://github.com/Webreaper/Damselfly-Base-Image/blob/main/Dockerfile|Docker file]]. 
- 
-There you go: 
-<code bash> 
-emerge -s media-fonts/liberation-fonts dev-dotnet/libgdiplus media-gfx/dcraw media-libs/exiftool 
-</code> 
- 
-The supposed //libgmp1// dependency is satisfied by adding **openmp** useflag to GCC (see [[https://forums.gentoo.org/viewtopic-p-5039135.html#6577903|here]]) which should be enabled by default in Gentoo. 
- 
- 
-==== Podman installation ==== 
- 
-Create the following //docker-compose.yml//: 
-<file - 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: {} 
-</file> 
- 
-And install it: 
-<code bash> 
-su - damselfly 
-podman compose pull 
-</code> 
- 
- 
-===== 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: 
-<file - damselfly.conf> 
-TBD 
-</file> 
- 
- 
-===== Startup ===== 
- 
- 
-==== Bare Metal running  ==== 
- 
-Start: 
-<code bash> 
-./Damselfly.Web /path/to/my/photos 
-</code> 
- 
-You will need the usual script & /etc/local.d/damselfly.start script for automatic start on boot. 
- 
-==== Podman running  ==== 
- 
-Running is, as usual: 
-<code bash> 
-su - damselfly 
-podman compose up 
-</code> 
- 
-To run at boot, add the following lines to your **/etc/local.d/80-containers.start**: 
-<code> 
-podman network create damselfly-net 
-su - damselfly -c "podman compose up -d" 
-</code> 
- 
-and the following lines to  **/etc/local.d/80-containers.stop**: 
-<code> 
-su - damselfly -c "podman compose down" 
-</code>