¶ lichtgewicht zoekmachine recoll in een docker container
Als beheerder ‘documenteer’ ik mijn activiteiten bij klanten, waarbij ik onderscheid maak tussen text-files en digitale content. De text-files komen in en subdirectory van directory work terecht, de digitale content in subdirectory van work_dir.
Op mijn windows11 laptop gebruik ik onderstaande scriptje mkwork_dir.cmd wat gebruik maakt van een stukje vbs scriptin (mkshortcut.vbs) om deze directories aan te maken met in iedere directory een shortcut naar elkaar.
mkwork_dir.cmd
@echo off
set /p cdir="Enter work name.: "
mkdir d:\work\%cdir%
mkdir d:\work_bin\%cdir%
mkshortcut /target:"d:\work_bin\%cdir%" /shortcut:"d:\work\%cdir%\%cdir%"
mkshortcut /target:"d:\work\%cdir%" /shortcut:"d:\work_bin\%cdir%\%cdir%"mkshortcut.vbs
set WshShell = WScript.CreateObject("WScript.Shell" )
set oShellLink = WshShell.CreateShortcut(Wscript.Arguments.Named("shortcut") & ".lnk")
oShellLink.TargetPath = Wscript.Arguments.Named("target")
oShellLink.WorkingDirectory = Wscript.Arguments.Named("startin")
oShellLink.WindowStyle = 1
oShellLink.SaveIn mijn zoektocht naar een mogelijkheid om de text-files eenvoudig te kunnen doorzoeken kwam ik uit bij een open-source project recoll (https://www.lesbonscomptes.com/recoll/pages/index-recoll.html).
Ondanks het feit dat deze tool ook beschikbaar is op Windows wilde ik liever een docker container hebben, om deze tool geïsoleerd te kunnen gebruiken. Dit wilde ik ontsluiten via een webinterface en vond recoll-webui (https://github.com/koniu/recoll-webui?tab=readme-ov-file). Dit github project is echter sterk verouderd en ik besloot zelf een versie te maken (ttps://github.com/rgeilings/recoll-webui).
¶ clone git repo
De eerste stap is om de git repository te clonen naar je eigen machine.
¶ eventueel aanpassen docker-compose.yml
In de directory vind je o.a. directory data. Dit is de directory waar ‘standaard’ gezocht wordt. Of liever gezegd, voor alle text-files in deze directory wordt een zoekindex opgebouwd.
Deze locatie is aan te passen in de docker-compose.yml file door docker volume - /data:/data te vervangen door het volledige pad naar bijvoorbeeld directory d:/work.
 |
 |
¶ installeer docker desktop
Installeer docker desktop voor windows: https://www.docker.com/products/docker-desktop/
¶ aanmaken docker container
Gebruik het docker-compose up -d commando om de docker container aan te maken. Let op dat je dit in de directory uitvoert, waar de docker-compose.yml file staat. Ik gebruik hiervoor git bash.
controleer of de docker container gestart is.
¶ indexeer de text-files
Om de text-files te indexeren moet je het commando recollindex ‘in’ de container uitvoeren. Met onderstaande commando worden de text-files geïndexeerd.
docker exec ageos_recoll-webui recollindexAfhankelijk van de hoeveelheid dat en je machine kan dit enige tijd duren.
¶ demo
Met de standaard instellingen in docker-compose.yml werkt recoll-webui op port 8080. Je gaat via http://localhost:8080/ naar recoll en vul nij ‘Query’ een zoekterm in. Door aanklikken van knop ‘"search’, gaat recoll op zoek en wordt het resultaat getoond.
Door met de muis over de gevonden tekst te gaan, komen links ‘Download’ en ‘Preview’ tevoorschijn. Door één van deze te selecteren wordt de file gedownload of vertoond.
¶ macbook geeft errors
Op dit moment heb ik op mijn macbook pro problemen met dit image. Hieraan wordt gewerkt.