Zum Inhalt springen
Serverküche
Suche

Die Suche wird geladen …

Anwendungen Schwierigkeit: Fortgeschritten

linkding: Lesezeichen selbst hosten

Alle Lesezeichen an einem Ort, geräteübergreifend und ohne Browser-Zwang: linkding als schlanker Bookmark-Manager hinter Traefik – mit Tags und API.

· Zuletzt aktualisiert: · 10 Min. Lesezeit ·Dauer: ca. 40 Minuten
Inhaltsverzeichnis

Lesezeichen im Browser sind an ein Gerät gebunden, chaotisch organisiert und weg, sobald das Profil kaputtgeht. linkding sammelt deine Links zentral auf dem eigenen Server: über den Browser, per Extension, per API – durchsuchbar, verschlagwortet und geräteübergreifend.

Was bauen wir?

Einen schlanken, selbst gehosteten Bookmark-Manager mit linkding (v1.47.0) hinter Traefik. Am Ende speicherst du Links mit einem Klick, versiehst sie mit Tags, findest sie per Volltextsuche wieder – und linkding holt Titel und Beschreibung automatisch von der verlinkten Seite. Dazu richten wir die REST-API ein, mit der du Lesezeichen aus Skripten heraus anlegst, und gehen die Einstellungen durch, die darüber entscheiden, welche Daten dein Server nach außen gibt.

linkding ist bewusst minimalistisch: ein einziger Container, SQLite statt eigener Datenbank, kein Cache, kein Suchindex-Dienst. Der ganze Zustand einer frischen Instanz mit den ersten Lesezeichen belegt knapp 1 MB auf der Platte.

Voraussetzungen

🍳 Empfehlung Anzeige

VPS 1000 G12.5

4 vCore · 8 GB RAM · 128 GB SSD

ab 14,50 €/Monat

linkding ist winzig – selbst der kleinste VPS langweilt sich damit.

Zu netcup →

💶 1 Monat gratis:

Einmal einlösbar, gilt für VPS 1000 G12.5. Im Warenkorb einlösen →

💶 5,95 € Gutschein für netcup-Neukunden: immer gültig · nicht für Domains und VPS Lite

Alle netcup-Gutscheine →

Schritt für Schritt

Schritt 1: Projekt und Compose-Datei

linkding speichert alles (Datenbank, Einstellungen, Favicons) in einem data-Ordner. Lege das Projekt an:

Terminal
mkdir -p /opt/linkding/data && cd /opt/linkding

Die compose.yaml – ersetze DEINE_DOMAIN. Das Admin-Konto erzeugt linkding beim ersten Start aus den Umgebungsvariablen:

YAML
services:
  linkding:
    image: sissbruecker/linkding:1.47.0
    restart: unless-stopped
    volumes:
      - ./data:/etc/linkding/data
    environment:
      LD_SUPERUSER_NAME: koch
      LD_SUPERUSER_PASSWORD: DEIN_STARKES_PASSWORT
      LD_CSRF_TRUSTED_ORIGINS: https://DEINE_DOMAIN
    networks: [proxy]
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.linkding.rule=Host(`DEINE_DOMAIN`)"
      - "traefik.http.routers.linkding.entrypoints=websecure"
      - "traefik.http.routers.linkding.tls.certresolver=le"
      - "traefik.http.services.linkding.loadbalancer.server.port=9090"

networks:
  proxy:
    external: true

Der Image-Tag ist bewusst auf 1.47.0 gepinnt statt auf latest: So bestimmst du, wann ein Update passiert, und ein docker compose pull zieht dir nicht unbemerkt eine neue Hauptversion herein. Der Port 9090 gehört in das loadbalancer.server.port-Label, weil linkding nicht auf 80 lauscht – ohne das Label rät Traefik falsch.

LD_CSRF_TRUSTED_ORIGINS ist eine Versicherung: Django prüft bei jedem POST, ob die Herkunft der Anfrage zum Hostnamen passt. Direkt hinter Traefik klappt das auch ohne den Eintrag, weil Traefik den Host-Header unverändert durchreicht. Schreibt aber ein weiterer Proxy davor den Host um oder läuft linkding unter einem Unterpfad, scheitert der Login mit einem CSRF-Fehler (siehe „Wenn es nicht funktioniert“) – der Eintrag kostet nichts und verhindert das.

Schritt 2: Starten und anmelden

Terminal
docker compose up -d

Das Image bringt einen eigenen Healthcheck mit, und Traefik leitet erst weiter, wenn der Container healthy meldet. Bis dahin, rund eine halbe Minute lang, bekommst du auf der Domain einen 404 von Traefik – kein Fehler, der Container steht nur noch nicht in der Routing-Tabelle. Den Status siehst du direkt:

Terminal
docker compose ps
Ausgabe
NAME                  IMAGE                          COMMAND            SERVICE    STATUS
linkding-linkding-1   sissbruecker/linkding:1.47.0   "./bootstrap.sh"   linkding   Up 39 seconds (healthy)

Sobald dort (healthy) steht, antwortet auch die Domain. Der Endpunkt /health ist ohne Anmeldung erreichbar und liefert die laufende Version mit – praktisch für Updates und Monitoring:

Terminal
curl https://DEINE_DOMAIN/health
Ausgabe
{"version": "1.47.0", "status": "healthy"}

Öffne dann https://DEINE_DOMAIN/ und melde dich mit dem Konto aus der Compose-Datei an:

Die Anmeldeseite von linkding unter der eigenen HTTPS-Domain
Der linkding-Login – die Zugangsdaten stammen aus der Compose-Datei

Passwort aus der Compose-Datei nehmen

LD_SUPERUSER_PASSWORD steht im Klartext in der compose.yaml und greift nur beim allerersten Start. Ändere das Passwort danach in der Oberfläche unter Settings → Change password und entferne die beiden LD_SUPERUSER_*-Zeilen wieder aus der Compose-Datei – sie werden nicht mehr gebraucht.

Schritt 3: Das erste Lesezeichen speichern

Klicke oben auf Add bookmark und füge eine URL ein. linkding ruft die Seite auf und füllt Titel und Beschreibung automatisch aus – du vergibst nur noch Tags (durch Leerzeichen getrennt, ohne #):

Das Formular zum Anlegen eines Lesezeichens mit automatisch gefülltem Titel und Beschreibung
„Add bookmark“: linkding holt Titel und Beschreibung selbst von der Seite; du ergänzt Tags

Das Abholen passiert auf deinem Server, nicht im Browser – die Zielseite sieht also die IP deines VPS und nicht deine eigene. Seit Version 1.47.0 schützt linkding diese serverseitigen Abrufe gegen SSRF, ruft also keine internen Adressen deines Netzes mehr ab, nur weil jemand sie als Lesezeichen einträgt.

Optional kannst du ein Lesezeichen als ungelesen markieren („Mark as unread“) – praktisch als Leseliste für später. Unter Notes passt eine eigene Notiz dazu, die nichts mit der Beschreibung der Zielseite zu tun hat.

Schritt 4: Sammlung durchsuchen und filtern

Die Übersicht zeigt deine Lesezeichen chronologisch, rechts eine anklickbare Tag-Wolke. Über die Suche findest du Links nach Wörtern oder #tags:

Die linkding-Übersicht mit mehreren Lesezeichen, Tags und Suchfeld
Die Bookmark-Liste: Titel, Tags und automatische Beschreibung, rechts die Tag-Navigation

Ein Klick auf ein Tag filtert sofort; mehrere Tags kombinieren die Filter – ganz ohne Ordnerhierarchie. Die Suche versteht seit Version 1.44 logische Ausdrücke: #docker and not #referenz findet alles mit dem Tag docker, das nicht gleichzeitig referenz trägt. Standardmäßig läuft die Tag-Suche im strict-Modus, Tags müssen also mit # geschrieben werden – sonst wären sie von normalen Suchwörtern nicht zu unterscheiden. Umstellen lässt sich das unter Settings → General → Tag search.

Schritt 5: Schnell speichern aus dem Browser

Für den Alltag willst du nicht jedes Mal die Weboberfläche öffnen. Unter Settings → Integrations findest du beide bequemen Wege plus den API-Zugang:

Die Integrations-Seite von linkding mit Browser-Extension, Bookmarklet und REST-API
Settings → Integrations: Extension, Bookmarklet, API-Token und RSS-Feeds an einer Stelle

  • Browser-Extension: Es gibt eine offizielle linkding-Erweiterung für Firefox und Chrome. In deren Einstellungen trägst du https://DEINE_DOMAIN und einen API-Token ein. Danach speicherst du die aktuelle Seite per Klick.
  • Bookmarklet: Ein Lesezeichen in der Browser-Leiste, das die aktuelle Seite direkt an linkding schickt. Funktioniert ohne Extension, auch auf dem Handy. Du kannst wählen, ob Titel und Beschreibung auf dem Server oder im Browser („Detect title and description in the browser“) ermittelt werden – die Browser-Variante hilft bei Seiten, die nur angemeldet lesbar sind oder automatisierte Zugriffe blocken.

Den Token erzeugst du im Abschnitt REST API über Create API token, mit einem sprechenden Namen pro Anwendung.

Der Token wird genau einmal angezeigt

Nach dem Anlegen erscheint der Token einmalig („Copy this token now, it will only be shown once“), danach steht in der Liste nur noch der Name. Ein Token mit vollem Zugriff auf alle Lesezeichen gehört in den Passwortmanager, nicht in ein Skript im Klartext – und pro Anwendung ein eigener, damit du einen einzelnen zurückziehen kannst, ohne alle anderen zu brechen.

Schritt 6: Lesezeichen per API verwalten

Mit dem Token wird linkding skriptbar. Lege ihn als Umgebungsvariable ab, damit er nicht in der Shell-History landet:

Terminal
read -rs LINKDING_TOKEN && export LINKDING_TOKEN

Die Authentifizierung läuft über einen Authorization-Header. Erster Test – die eigenen Lesezeichen auflisten:

Terminal
curl -H "Authorization: Token $LINKDING_TOKEN" \
  "https://DEINE_DOMAIN/api/bookmarks/?limit=1"
Ausgabe
{
    "count": 4,
    "next": "https://DEINE_DOMAIN/api/bookmarks/?limit=1&offset=1",
    "previous": null,
    "results": [
        {
            "id": 4,
            "url": "https://serverkueche.de/",
            "title": "Serverküche – Selfhosting-Tutorials, frisch serviert",
            "description": "Praxisnahe Schritt-für-Schritt-Anleitungen fürs Selfhosting …",
            "notes": "",
            "is_archived": false,
            "unread": false,
            "shared": false,
            "tag_names": [
                "docker",
                "selfhosting",
                "serverkueche"
            ],
            "date_added": "2026-09-27T23:54:21.396342Z",
            "date_modified": "2026-09-27T23:54:21.396350Z"
        }
    ]
}

Ein neues Lesezeichen anlegen ist ein POST mit JSON. Titel und Beschreibung darfst du weglassen – linkding holt sie auch hier selbst von der Seite:

Terminal
curl -X POST \
  -H "Authorization: Token $LINKDING_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.debian.org/releases/trixie/","tag_names":["debian","release"],"unread":true}' \
  "https://DEINE_DOMAIN/api/bookmarks/"
Ausgabe
{
  "id": 5,
  "url": "https://www.debian.org/releases/trixie/",
  "title": "Debian -- Debian “trixie” Release Information",
  "tag_names": [
    "debian",
    "release"
  ],
  "unread": true
}

Das Feld heißt tag_names, nicht tags: Schickst du "tags": [...], wird das Lesezeichen ohne Fehlermeldung angelegt, aber mit "tag_names": []. Prüfe deshalb die Antwort des ersten Aufrufs, bevor du eine Importschleife darüber laufen lässt.

Suchen geht genauso wie in der Oberfläche, über den Parameter q (das # muss URL-kodiert als %23 hinein):

Terminal
curl -H "Authorization: Token $LINKDING_TOKEN" \
  "https://DEINE_DOMAIN/api/bookmarks/?q=%23docker"

Ohne gültigen Token antwortet jeder API-Endpunkt mit 401 – die API ist also nicht versehentlich offen:

Ausgabe
{"detail":"Authentication credentials were not provided."}

Schritt 7: Einstellungen, die den Unterschied machen

Unter Settings → General stehen vier Optionen, die du einmal bewusst durchgehen solltest.

Auto Tagging vergibt Tags anhand der URL, ohne dass du sie tippst. Jede Zeile ist eine Regel aus Domain (oder Domain plus Pfad) und den Tags dahinter:

Ausgabe
docs.docker.com doku docker
debian.org debian linux
reddit.com/r/selfhosted selfhosting reddit

Die Regeln greifen auch für Lesezeichen aus API und Extension: Ein POST auf https://docs.docker.com/compose/ ohne tag_names kommt mit ["docker", "doku"] zurück.

Enable Favicons ist ab Werk aus. Schaltest du es ein, lädt linkding die Icons standardmäßig über einen Google-Dienst nach – ein unschöner Rückkanal, denn Google erfährt so von jeder Domain, die du speicherst. Die linkding-Doku nennt DuckDuckGo als Alternative; dazu eine Zeile in die Compose-Datei ergänzen:

YAML
      LD_FAVICON_PROVIDER: https://icons.duckduckgo.com/ip3/{domain}.ico

Nach docker compose up -d und dem Aktivieren landen die Icons als .ico-Dateien unter data/favicons/ – Google liefert PNGs, daran erkennst du, welcher Anbieter gegriffen hat.

Internet Archive integration ist ebenfalls aus und sollte das bleiben, wenn du es nicht ausdrücklich willst: Eingeschaltet meldet linkding jede gespeicherte URL an die Wayback Machine – nützlich, wenn das Original verschwindet, aber deine Leseliste wird damit bei einem Dritten sichtbar.

Enable public bookmark sharing (ab Werk aus) macht als shared markierte Lesezeichen ohne Anmeldung erreichbar – jeder mit der Adresse deiner Instanz sieht diese Liste.

Brauchst du einen zusätzlichen Riegel vor der Anmeldeseite, gehören Rate-Limit und Security-Header in den Proxy statt in die App – wie das geht, steht in Traefik-Middlewares absichern.

Wenn es nicht funktioniert

Die Seite kommt nicht, Traefik antwortet mit 404, obwohl der Container läuft. Der Healthcheck ist noch nicht healthy (siehe Schritt 2). Status prüfen mit docker compose ps oder docker inspect -f '{{.State.Health.Status}}' linkding-linkding-1; bleibt es dauerhaft auf unhealthy, verraten docker compose logs linkding den Grund.

Das Anmeldeformular antwortet mit Forbidden (403) CSRF verification failed. Die Login-Seite selbst lädt normal, aber Django hat die Herkunft der Anfrage nicht als vertrauenswürdig erkannt – typisch, wenn ein Proxy vor Traefik den Host-Header umschreibt oder linkding unter einem Unterpfad läuft. LD_CSRF_TRUSTED_ORIGINS: https://DEINE_DOMAIN ergänzen (mit https://, ohne Pfad und ohne abschließenden Schrägstrich) und docker compose up -d.

Titel und Beschreibung werden nicht automatisch geholt. Die Zielseite blockiert automatisierte Zugriffe oder antwortet zu langsam. Trage beides von Hand ein oder stelle das Bookmarklet auf Erkennung im Browser um (Schritt 5).

Das Admin-Konto wurde nicht angelegt. LD_SUPERUSER_NAME und LD_SUPERUSER_PASSWORD greifen nur beim ersten Start mit leerer Datenbank. Existiert data/db.sqlite3 schon, ändert eine spätere Anpassung nichts. Konto nachträglich anlegen: docker compose exec linkding python manage.py createsuperuser.

Die API oder die Extension antwortet mit 401. Entweder fehlt der Token, oder er ist falsch: {"detail":"Authentication credentials were not provided."} heißt, der Authorization-Header kam gar nicht an, {"detail":"Invalid token."} heißt, der Token stimmt nicht. Da ein Token nur einmal angezeigt wird, ist Neuerzeugen unter Settings → Integrations der schnellere Weg als Suchen. Als Server exakt https://DEINE_DOMAIN eintragen, ohne Pfad dahinter.

Dein Problem ist nicht dabei? Alle Fehlermeldungen durchsuchen →

Wartung & Backups

  • Updates. Setze den Image-Tag (sissbruecker/linkding:1.47.0) auf die aktuelle Version und starte mit docker compose up -d neu; die Datenbank migriert beim Start automatisch. Ob die neue Version läuft, zeigt curl https://DEINE_DOMAIN/health. Der Rest läuft über deinen normalen Update-Prozess.

  • Backup: der data-Ordner – aber bitte konsistent. Der gesamte Zustand liegt in data/. Der Haken: linkding betreibt SQLite im WAL-Modus, und bei einer frischen Instanz kann mehr als die Hälfte der Daten noch in db.sqlite3-wal statt in db.sqlite3 liegen – wer nur die .sqlite3-Datei wegsichert, verliert also den größeren Teil. Entweder du sicherst den kompletten Ordner inklusive -wal und -shm, oder du legst vorher einen in sich konsistenten Schnappschuss an:

    Terminal
    docker compose exec -T linkding python -c \
      "import sqlite3; s=sqlite3.connect('data/db.sqlite3'); \
       d=sqlite3.connect('data/db-backup.sqlite3'); s.backup(d); d.close(); s.close()"

    Das nutzt SQLites Online-Backup-Schnittstelle und funktioniert im laufenden Betrieb – ein sqlite3-Kommandozeilenwerkzeug bringt das Image nicht mit. Die entstehende data/db-backup.sqlite3 nimmst du zusammen mit dem Ordner ins Restic-Backup.

  • Zusätzlich ein HTML-Export. Unter Settings → Export lädst du deine Sammlung als bookmarks_JAHR-MONAT-TAG_HH-MM-SS.html im Netscape-Bookmark-Format herunter – dasselbe Format, das jeder Browser importiert. Das ist dein dienstunabhängiges Notfall-Backup: Selbst wenn linkding nicht mehr startet, bleiben die Links samt Tags und Beschreibungen lesbar. Der umgekehrte Weg (Settings → Import) bringt bestehende Lesezeichen aus Browser oder Altdienst herein und macht aus Ordnern Tags.

  • Aufwand geht gegen null. linkding ist ein „einrichten und vergessen“-Dienst: ein Container, keine Hintergrunddienste und im Leerlauf rund 240 MB Arbeitsspeicher.

Feedback per E-Mail: feedback@serverkueche.de

Das könnte dir auch schmecken