Karakeep als Alternative zu Pocket

Vorwort #

Pocket wird Anfang Juli ‘25 abgeschaltet und im Oktober wird kurzer Prozess gemacht und die Konten werden gelöscht, also brauchen wir eine Alternative. Am besten selbstgehostet und open source. Nach etwas herumsuchen bin ich bei Karakeep gelandet, es gibt aber zum Glück eine ganze Batterie an Alternativen:

• Karakeep
• Omnivore
• Grimoire
• Wallabag
• Readeck

und das sind nur ein paar der Optionen.

Schlussendlich hatte ich bei meiner kurzen Recherche den Eindruck dass Karakeep (vormals Hoarder) und Wallabag den besten Eindruck machen. Beide verfügen über eine solide UI, Extensions für die gängigen Browser und mobile Apps für unterwegs.

Karakeep wirbt zusätzlich noch mit einer AI Integration von Ollama oder ChatGPT für automatisches Tagging, Video Transcription, OCR usw. Da ich gerade mit einer ChatGPT Plus Membership experimentiere bin ich deshalb erst einmal bei Karakeep gelandet.

Administration #

Installation #

Die Installation gestaltet sich dank Docker Compose sehr einfach:

services:
  Karakeep:
    image: ghcr.io/karakeep-app/karakeep:${KARAKEEP_VERSION:-release}
    restart: unless-stopped
    volumes:
      # By default, the data is stored in a docker volume called "data".
      # If you want to mount a custom directory, change the volume mapping to:
      - /dein/lokaler/Datenordner:/data #mappt lokales Filesystem auf den /data Ordner im Container
      #- data:/data
    ports:
      - 3000:3000 # Port außen:Port im Container
    environment:
      NEXTAUTH_SECRET: # hier zufälliger Key -> bspw. generieren über: openssl rand -base64 36
      MEILI_ADDR: http://meilisearch:7700
      BROWSER_WEB_URL: http://chrome:9222
      # OPENAI_API_KEY: ...

      # You almost never want to change the value of the DATA_DIR variable.
      # If you want to mount a custom directory, change the volume mapping above instead.
      DATA_DIR: /data # DON'T CHANGE THIS
  chrome:
    image: gcr.io/zenika-hub/alpine-chrome:123
    restart: unless-stopped
    command:
      - --no-sandbox
      - --disable-gpu
      - --disable-dev-shm-usage
      - --remote-debugging-address=0.0.0.0
      - --remote-debugging-port=9222
      - --hide-scrollbars
  meilisearch:
    image: getmeili/meilisearch:v1.13.3
    restart: unless-stopped
    environment:
      MEILI_NO_ANALYTICS: "true"
      MEILI_MASTER_KEY: # hier zufälliger Key -> bspw. generieren über: openssl rand -base64 36
    volumes:
      - meilisearch:/meili_data
volumes:
  meilisearch: null
  data: null
networks:
  nginx-net:
    external: true

Das ist erstmal die Basiskonfiguration laut Anleitung bei Karakeep. Zu beachten fand ich hierbei dass man einmal selbst die Auth-Keys generieren muss mit denen NextAuth und MeiliSearch arbeiten. Das geht aber ganz einfach aus der Kommandozeile mit dem Befehl:

openssl rand -base64 36

Was mich aber eine Weile zur Verzweiflung getrieben hat war dass ich ständig eine Exception bekommen habe beim Aufruf der Applikation. Am Ende hat sich herausgestellt dass ich, weil ich mit Docker Compose über Dockge die Container starte, die Einträge für die beiden Keys direkt wie oben angegeben als environment Variablen in der docker-compose.yml übergeben musste. Den separaten Eintrag aus dem .env file will entweder Dockge oder Docker Compose in diesem Fall nicht korrekt verarbeiten.

Apropos env File:

Environment Variablen #

Das .env File sollte laut Anleitung folgende Standard Variablen enthalten:

KARAKEEP_VERSION=release
NEXTAUTH_SECRET=super_random_string
MEILI_MASTER_KEY=another_random_string
NEXTAUTH_URL=http://localhost:3000 # falls ihr eine Subdomain habt kommt die hier rein

eine ausführliche Liste mit Variablen, bspw. zur Integration von OpenAI findet sich hier. Nachfolgend die Variablen die ich angepasst habe:

OpenAI Api Key erstellen #

Damit Karakeep auf die OpenAI API zugreifen kann benötigt man einen API-Key. Diesen kann man im OpenAI Dashboard in seinem Account erstellen:

Diesen Key direkt kopieren, er wird nur einmal angezeigt. Danach dann den Key in die OPENAI_API_KEY Variable eintragen.

Container starten, Reverse Proxy konfigurieren und andere Arbeiten #

Im Anschluss, abhängig von eurer Konfiguration müsst ihr den Karakeep Hauptcontainer starten und noch in euer Container-Netzwerk einbinden. Ich habe hier ein eigenes Netz für einen NGINX Proxy Manager eingerichtet der sich um die Zertifikate kümmert und Anfragen an die Subdomain weiterleitet die ich für Karakeep eingerichtet habe. Betreibt ihr Karakeep lokal sollte es einfach über http://localhost:3000 erreichbar sein.

In meinem Fall sah der weitere Workflow so aus:

Container starten #

läuft in meinem Fall über die Dockge WebUi, ansonsten über

docker compose up -d

checken ob die Container hochgekommen sind #

docker ps|grep kara

Falls kein Docker Netzwerk vorhanden, eins anlegen #

docker network create nginx-net

Container in das Netzwerk hängen #

Es sollte mehrere Karakeep Container geben, ihr braucht den Hauptcontainer der auf dem in der Compose Datei festgelegten Ports antwortet. Den Namen könnt ihr aus dem Ergebnis des docker ps Befehls kopieren:

docker network connect <Netzwerkname> <Containername>

checken ob der Container im Docker Netzwerk hängt #

docker network inspect <Netzwerkname>

Login und Usage #

Wenn alles geklappt hat können wir nun die Karakeep Login Seite entweder über localhost:3000 oder den in eurem Reverse Proxy konfigurierten Link erreichen:

Beim ersten Login/Sign Up wird automatisch ein Admin Benutzer angelegt. Da

Man kann nun entweder über das NEW ITEM Feld einen Link, Notiz oder Screenshot einfügen oder direkt Webseiten über die Browser Extensions oder mobile Apps hinzufügen. Die Apps sind selbsterklärend und erwarten die URL für eure Karakeep Instanz und eure Zugangsdaten für euren Karakeep User.

User Einstellungen #

In den User Einstellungen kann man dann weitere Dinge konfigurieren wie RSS Feeds die gecrawled werden sollen, Prompts für die AI Zusammenfassung von Texten usw. Die User Settings erreicht ihr über das Menü rechts oben:

Hier kann man dann alles von AI über Webhooks, RSS Feeds oder auch Imports aus anderen Tools wie Omnivore, Pocket, Linkwarden usw. durchführen oder auch API Keys generieren. Wir werden einen API Key im nächsten Teil benötigen, also könnt ihr auch direkt einen anlegen.

Einträge bearbeiten #

Einzelne Einträge sehen so aus:

Über die beiden Symbole rechts unten kann man entweder weitere Optionen über die ... anzeigen (bspw. einen neuen Crawl anstoßen, Eintrag archivieren, löschen…)

Oder man kann den detaillierten Eintrag aufrufen über das maximieren Symbol. Hier findet man bspw. die Option Tags zu bearbeiten, findet einen Transcript zum Inhalt und kann sich auf Wunsch eine Zusammenfassung per AI einfügen lassen oder eigene Notizen schreiben:

Die Zusammenfassung mittels AI sieht dann bspw. so aus:

Achtet nur darauf, dass dies ggf. OpenAI Tokens kostet und damit nicht kostenfrei ist. Ich beobachte mal wie teuer der ganze Spaß ist und poste dann einen Nachtrag in ein paar Wochen oder Monaten.

Einbinden SingleFile Extension als Workaround für Captcha Sites #

Leider musste ich feststellen, dass Seiten die durch CAPTCHAS gesichert sind nicht so einfach mit Karakeep funktionieren (was technisch natürlich auch so gewollt ist). Ein Workaround ist momentan die Verwendung der SingleFile Extension als Browser Extension für Firefox oder Chrome. Diese Extension erlaubt es eine ganze Website als html Datei zu speichern. Karakeep erlaubt es dann diese Seite als Asset hochzuladen und zu verarbeiten.

Momentan funktioniert diese Lösung nur mit dem aktuellen Nightly Release, soll aber mit in das nächste Release einfließen. Deshalb verweise ich hier nur auf die Anleitung bei Karakeep selbst, da sich natürlich noch einiges ändern kann und nicht jeder den instabilen Nightly Build verwenden möchte.

Hier die momentane Anleitung in Stichpunkten:

1. Installiere die SingleFile extension.
2. In den Einstellungen der Extension auswählen Destinations.
3. Wähle upload to a REST Form API.
4. Bei der URL folgendes eintragen: https://YOUR_SERVER_ADDRESS/api/v1/bookmarks/singlefile.
5. Beim authorization token den API Token eintragen den ihr euch in den User Settings von Karakeep generiert habt
6. Dasdata field name auffile.
7. DasURL field name auf url.
8. (Optional) Fügt &ifexists=MODE zum URL Feld hinzu MODE entspricht einem der Werte: skip, overwrite, overwrite-recrawl, append, oder append-recrawl. Bei mir steht dies gerade auf overwrite
9. Man sollte außerdem noch die MAX_ASSET_SIZE_MB: 100 in den ENV Variablen setzen. Standard ist 4MB und das könnte zu wenig sein, da die gerippten Seiten ggf. relativ groß werden