SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-11-20

Hister selbst hosten: persönliche Suchmaschine einrichten

Installieren Sie Hister auf einem VPS und durchsuchen Sie besuchte Seiten und Dateien per Volltext. Mit Binary- oder Docker-Setup, TLS, Login und MCP-Endpunkt.

Was Hister ist und was es nicht ist

Hister ist eine persönliche Suchmaschine, die Sie selbst hosten. Sie indiziert den vollständigen Text der von Ihnen besuchten Seiten und der von Ihnen gespeicherten Dateien. Anschließend können Sie diese Sammlung über eine Weboberfläche, einen Terminal-Client, eine HTTP-API oder einen KI-Assistenten (künstliche Intelligenz) durchsuchen. Hister beantwortet eine Frage: Wo habe ich das gelesen?

Die meisten Leser lernen dieses Konzept über SearXNG kennen. Beide sind jedoch nicht dasselbe Tool. Wenn Sie den älteren Namen Searx kennen, wird dieses Projekt nicht mehr gepflegt, und die README verweist inzwischen auf Hister als neues Projekt seines Autors. Searx und SearXNG bleiben getrennte Projekte. SearXNG ist der gepflegte Fork und daher die richtige Wahl, wenn Sie eine neue Metasuchinstanz einrichten. SearXNG ist ein Metasuch-Proxy. Ihre Suchanfrage wird an SearXNG gesendet. SearXNG fragt in Ihrem Auftrag andere Suchmaschinen ab und gibt deren Ergebnisse ohne Tracking zurück. Der Index gehört diesen Suchmaschinen. Hister erstellt seinen eigenen Index aus Inhalten, die Sie ihm bereitstellen: von einer Browser-Erweiterung erfasste Seiten, importierte Browserverläufe, gecrawlte URLs und Dateien in Verzeichnissen, die Sie angeben. Eine selbst gehostete SearXNG-Instanz ermöglicht Ihnen privaten Zugriff auf das öffentliche Web. Hister ermöglicht die Suche in Ihrer eigenen Lektüre. Die Aufgaben sind unterschiedlich. Daher ist es normal, beide Dienste auf einem Server zu betreiben. In diesem Fall sollten Sie wissen, wie viel Ihrer Suchvorgänge SearXNG tatsächlich verbirgt, denn SearXNG ersetzt bei den Suchmaschinen Ihre IP-Adresse durch die Ihres Servers, anstatt die Suchanfragen selbst zu verbergen.

Hister ist freie Software unter der AGPLv3 (GNU Affero General Public License, Version 3) oder einer späteren Version. Es enthält keine Telemetrie und benötigt keinen Cloud-Dienst. Diese Anleitung verwendet fest die Version v0.17.0. Das war am 2026-07-28 die aktuelle Version. Am 2026-10-12 war v0.20.0 die aktuelle Version. Am 2026-10-29 war v0.21.0 die aktuelle Version. Am 2026-11-19 ist v0.22.0 die aktuelle Version. Dies ist die erste Version unter dem neuen Projektnamen Nogon. Die folgenden Befehle wurden für v0.17.0 erstellt. Die wenigen hier erwähnten Funktionen, die später hinzugekommen sind, sind mit der Version gekennzeichnet, in der sie eingeführt wurden. Prüfen Sie vor dem Kopieren auf der Releases-Seite den aktuellen Tag. Legen Sie anschließend den dort gefundenen Tag fest.

Ein Upgrade auf v0.22.0 erfordert mehr, als nur die Versionsnummer weiter unten zu ersetzen. Neue Downloads verwenden den Binärnamen nogon. config create ersetzt create-config. user create und user update ersetzen create-user und update-user. Stoppen Sie den Server und erstellen Sie vor dem Upgrade ein vollständiges Backup. Behalten Sie dabei die vorhandenen Datenpfade und Container-Volumes bei. Vorhandene Installationen der Browser-Erweiterung erhalten die Umbenennung über Store-Updates und behalten ihre Einstellungen.

Warum Hister auf einem VPS selbst hosten

Ein Index ist nur dann nützlich, wenn er vollständig ist. Vollständig ist er nur, wenn der Server während des Lesens lief. Ein Laptop befindet sich den halben Tag im Energiesparmodus. Seiten, die Sie in dieser Zeit auf dem Smartphone öffnen, erreichen ihn nicht. Auch ein nächtlicher Import startet dann nicht. Ein VPS (virtual private server) bleibt aktiv. Dadurch überträgt jedes Ihrer Geräte Inhalte in denselben Index, und der Crawler arbeitet weiter, während Sie schlafen.

Der zweite Grund ist die Trennung. Wenn Sie user_handling: true im Abschnitt app festlegen, erhält jedes Konto auf einer einzelnen Instanz eigene Zugangsdaten und eine eigene Dokumentsammlung. Ein Server kann dadurch einen Haushalt oder ein kleines Team aufnehmen, ohne dass jemand die Lektüre einer anderen Person durchsuchen kann.

Der dritte Grund ist die Infrastruktur. Der VPS verfügt bereits über einen öffentlichen Hostnamen und ein Zertifikat. Beides benötigt die Browser-Erweiterung, um den Server aus einem Netzwerk zu erreichen, das Sie nicht kontrollieren. Dieses Paar erfüllt auf dem System noch eine weitere Funktion, denn openGym registriert seinen ersten Passkey unter dem Hostnamen, der zu diesem Zeitpunkt aktiv ist. Daher müssen der Name und das Zertifikat feststehen, bevor das erste Konto erstellt wird.

Installationsweg 1: das Release-Binary

Hister veröffentlicht pro Plattform ein Binary. Laden Sie es zusammen mit der Prüfsummendatei herunter und verifizieren Sie es vor der Installation.

cd /tmp
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_linux_amd64
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_checksums.txt
sha256sum --ignore-missing -c hister_0.17.0_checksums.txt

Ein korrektes Ergebnis besteht aus der einzelnen Zeile hister_0.17.0_linux_amd64: OK. Eine Zeile mit FAILED bedeutet, dass der Download beschädigt oder verändert wurde. Laden Sie die Datei in diesem Fall erneut herunter, statt sie zu installieren.

Installieren Sie das Binary. Erstellen Sie anschließend ein Systemkonto und die Verzeichnisse, die es verwendet.

sudo install -m 755 /tmp/hister_0.17.0_linux_amd64 /usr/local/bin/hister
sudo useradd --system --home-dir /var/lib/hister --shell /usr/sbin/nologin hister
sudo install -d -o hister -g hister -m 750 /var/lib/hister
sudo install -d -m 755 /etc/hister
sudo hister create-config /etc/hister/config.yml

create-config schreibt eine Standardkonfigurationsdatei. Der Befehl bestätigt außerdem, dass das Binary auf diesem Computer ausgeführt werden kann. Ein Download für die falsche Architektur schlägt an dieser Stelle mit cannot execute binary file: Exec format error fehl.

Bearbeiten Sie die wenigen relevanten Einstellungen. Der übrige Inhalt der generierten Datei kann unverändert bleiben.

app:
  directory: /var/lib/hister
  access_token: 'paste-a-long-random-string-here'
server:
  address: 127.0.0.1:4433
  base_url: https://hister.example.com

Generieren Sie das Token mit openssl rand -hex 32. Die Datei enthält nun ein Zugangstoken. Beschränken Sie daher die Dateiberechtigungen, bevor der Dienst gestartet wird.

sudo chown root:hister /etc/hister/config.yml
sudo chmod 640 /etc/hister/config.yml

Unter systemd ausführen

Schreiben Sie /etc/systemd/system/hister.service:

[Unit]
Description=Hister personal search engine
After=network-online.target
Wants=network-online.target

[Service]
User=hister
Group=hister
Environment=HISTER_CONFIG=/etc/hister/config.yml
ExecStart=/usr/local/bin/hister listen
Restart=on-failure
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ReadWritePaths=/var/lib/hister

[Install]
WantedBy=multi-user.target

HISTER_CONFIG ist die dokumentierte Umgebungsvariable für den Konfigurationspfad. Dadurch hängt die Unit nicht vom Home-Verzeichnis des Kontos hister ab. ProtectSystem=strict macht das gesamte Dateisystem für diesen Dienst schreibgeschützt. Deshalb muss ReadWritePaths das Datenverzeichnis angeben. ProtectHome=yes blendet /home für den Dienst aus. Ein überwachtetes Verzeichnis unter /home würde dem Indexer daher leer erscheinen. Entfernen Sie diese Zeile, wenn Sie dort Dateien indizieren müssen.

sudo systemctl daemon-reload
sudo systemctl enable --now hister
systemctl status hister --no-pager
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4433/

Jeder HTTP-Statuscode, den der letzte Befehl ausgibt, bedeutet, dass der Prozess auf Verbindungen wartet. curl: (7) Failed to connect bedeutet, dass dies nicht der Fall ist. journalctl -u hister -n 50 --no-pager zeigt den Grund.

Installationsmethode zwei: Docker Compose

Das Image wird in der GitHub Container Registry veröffentlicht, mit einem Tag pro Release.

services:
  hister:
    image: ghcr.io/asciimoo/hister:v0.17.0
    container_name: hister
    user: '1000:1000'
    restart: unless-stopped
    environment:
      - HISTER__SERVER__ADDRESS=0.0.0.0:4433
      - HISTER__SERVER__BASE_URL=https://hister.example.com
      - HISTER__APP__ACCESS_TOKEN=${HISTER_ACCESS_TOKEN}
    volumes:
      - ./data:/hister/data
    ports:
      - 127.0.0.1:4433:4433

Für jeden Konfigurationsschlüssel gibt es einen Umgebungsvariablen-Override in der Form HISTER__<SECTION>__<KEY>. Als Trennzeichen dienen zwei Unterstriche. Für eine Container-Bereitstellung ist daher keine eingebundene Konfigurationsdatei erforderlich. Speichern Sie HISTER_ACCESS_TOKEN in einer .env-Datei neben der Compose-Datei. Wenn Sie lieber eine Datei bearbeiten, gibt docker run --rm ghcr.io/asciimoo/hister:v0.17.0 create-config > config.yml die Standardwerte aus.

Die beiden oben genannten Zeilen können leicht falsch konfiguriert werden. Beide Zusammenhänge sollten Sie verstehen.

Die Adresse im Container muss 0.0.0.0:4433 lauten. Ein Container hat einen eigenen Netzwerk-Namespace. Ein Prozess, der dort an 127.0.0.1 gebunden ist, kann daher nur aus diesem Container erreicht werden. Für den veröffentlichten Port gibt es dann kein Ziel.

Der veröffentlichte Port muss als 127.0.0.1:4433:4433 und nicht als 4433:4433 angegeben werden. Docker veröffentlicht Ports, indem es eigene netfilter-Regeln einfügt. Diese Regeln werden vor den ufw-Regeln ausgewertet. Deshalb bleibt ein einfacher 4433:4433 aus dem Internet erreichbar, selbst wenn ufw status auf einem System den Port als geschlossen anzeigt. Wenn Sie die Host-Seite an 127.0.0.1 binden, bleibt der Reverse Proxy der einzige Zugangsweg. Die gleiche Falle gilt für jeden Container auf dem Server. Docker Compose auf einem VPS behandelt die übrigen Aspekte.

Die user: '1000:1000'-Zeile führt den Container mit UID 1000 und GID 1000 aus. Damit überschreibt sie die Standard-UID und -GID 65532 des offiziellen Images v0.17.0. Daher muss ./data für UID 1000 und GID 1000 beschreibbar sein. Wenn das Verzeichnis nicht existiert, erstellen Sie es mit mkdir -p ./data. Mit sudo chown -R 1000:1000 ./data übertragen Sie den Besitz an dieses Konto. Auf einem Host mit aktiviertem SELinux verwenden Sie ./data:/hister/data:Z, damit Docker ein passendes Label zuweist. Wenn Ihnen diese Zahlen nicht vertraut sind, lesen Sie zuerst mit welcher UID und GID ein Container Dateien schreibt.

Warum Sie einen persönlichen Suchindex niemals offen zugänglich machen sollten

Hister lauscht standardmäßig auf 127.0.0.1:4433. Dieser Standardwert ist bewusst gewählt. Überlegen Sie, welche Inhalte der Index nach einem Monat Nutzung enthält: interne Wiki-Seiten, Rechnungen, Support-Tickets, die Sie während einer angemeldeten Sitzung erstellt haben, Seiten zum Zurücksetzen von Passwörtern und den vollständigen Text aller anderen Inhalte, die Sie gelesen haben. In der Projektdokumentation steht es ausdrücklich: „Hister überträgt Ihren vollständigen Browserverlauf einschließlich der Seiteninhalte zum Server und vom Server.“

Eine offengelegte Passwortdatenbank muss zunächst geknackt werden. Ein offengelegter persönlicher Index liegt dagegen im Klartext vor und ist bereits durchsuchbar. Er erfordert daher mehr Schutz als die kleine Self-Hosting-Anwendung, der er ähnelt.

Daraus ergeben sich zwei Punkte. Hister verlangt standardmäßig keine Authentifizierung. Ein Reverse Proxy veröffentlicht daher allein bereits eine durchsuchbare Kopie Ihrer gelesenen Inhalte für jeden, der den Hostnamen kennt. Der MCP-Endpunkt wird standardmäßig ebenfalls unter /mcp bereitgestellt. Ohne Token kann jeder Client, der ihn erreicht, eine Suche im Index ausführen.

Konfigurieren Sie die Authentifizierung, bevor der Dienst erstmals nicht mehr nur auf localhost erreichbar ist. Für einen einzelnen Benutzer genügt app.access_token. Dabei wird ein gemeinsames Secret verwendet, das von der Browsererweiterung, dem Terminal-Client und jedem MCP-Client gesendet wird. Für mehrere Personen setzen Sie user_handling: true und erstellen Konten:

sudo -u hister hister create-user alice --admin --config /etc/hister/config.yml

Der Befehl fordert ein Passwort mit 8 bis 72 UTF-8-Bytes an. Ein Unicode-Zeichen kann mehrere Bytes belegen. Daher können auch weniger als acht Zeichen die Bedingung erfüllen. Jedes Konto erhält eigene Dokumente und ein persönliches API-Token. Der Kontoinhaber kann dieses auf der Profilseite oder mit dem Flag --regen-token bei hister update-user neu erzeugen. Ein neues Token macht das vorherige sofort ungültig. Daher müssen Sie anschließend jedes von diesem Konto verwendete Gerät aktualisieren.

Lassen Sie app.public unverändert, sofern Sie diese Einstellung nicht ausdrücklich benötigen. Der öffentliche Modus erlaubt die Suche ohne Authentifizierung, Vorschauen, das Bereitstellen von Dateien und die MCP-Suche. Schreibzugriffe, der Zugriff auf den Verlauf und Administratorvorgänge bleiben dennoch gesperrt.

Reverse Proxy, TLS und Firewall

Hister stellt HTTPS nicht selbst bereit. Beenden Sie TLS (Transport Layer Security) daher vor Hister. Caddy ist dafür der kürzeste Weg, weil es Zertifikate über ACME (Automatic Certificate Management Environment) selbst anfordert und erneuert.

hister.example.com {
    reverse_proxy 127.0.0.1:4433
}

Laden Sie die Konfiguration mit sudo systemctl reload caddy neu. Für diese Konfiguration müssen die DNS-Einträge für hister.example.com auf diesen Server zeigen. Das kann ein A-Record für IPv4, ein AAAA-Record für IPv6 oder beides sein. Caddy aktiviert standardmäßig sowohl die HTTP-01-Validierung über Port 80 als auch die TLS-ALPN-01-Validierung über Port 443. Port 80 ist daher nicht erforderlich, wenn die Validierung über Port 443 erfolgreich ist. Let's Encrypt validiert sowohl über IPv6 als auch über IPv4 und versucht zuerst die AAAA-Adresse. Ein veralteter AAAA-Record eines früheren Hosts kann die Validierung daher verhindern, obwohl der A-Record korrekt ist. Wenn die DNS-Konfiguration fehlerhaft ist oder keine der beiden Challenges erfolgreich ist, zeigt der Browser einen TLS-Fehler statt der Seite an. Im Caddy-Log wird die fehlgeschlagene Challenge wiederholt protokolliert.

Schließen Sie anschließend alle anderen Ports.

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

Port 4433 fehlt absichtlich in dieser Liste. Ein öffentlicher Hostname ist außerdem nicht der einzige Zugangsweg. Auch ein Onion-Dienst, der auf denselben Loopback-Port zeigt, erreicht Ihren Index von Ihren eigenen Geräten aus, ohne DNS-Eintrag und ohne geöffneten eingehenden Port.

server.base_url muss einschließlich des Schemas der Adresse entsprechen, die Sie im Browser eingeben. Ein falscher Pfadpräfix in base_url beschädigt die Asset-Links. Dadurch enthält die Oberfläche unformatierten Text, und Bilder fehlen. Dieselbe URL tragen Sie in die Browser-Erweiterung ein.

Index füllen

Die Browser-Erweiterung ist der wichtigste Collector. Installieren Sie sie über Mozilla Add-ons oder den Chrome Web Store, öffnen Sie ihre Optionsseite, setzen Sie die Server-URL auf https://hister.example.com und fügen Sie das Access-Token ein. Die Token-Unterstützung wurde mit v0.18.0 in die Erweiterung aufgenommen. Die Erweiterung v0.17.0 verwendet stattdessen die Sitzung der Anmeldung an der Weboberfläche. Anschließend erfasst sie den Titel, den vollständigen Text, das HTML und das Favicon jeder von Ihnen besuchten Seite und sendet diese Daten an Ihren Server. Die Extraktion erfolgt clientseitig im Browser. Die Erweiterung kontaktiert keine Drittanbieter. Die einzige externe Anfrage betrifft das Favicon der Seite.

Die clientseitige Extraktion ermöglicht einen privaten Index. Die Erweiterung sieht eine Seite genau so, wie Sie sie sehen, also nach der Anmeldung und nach dem Rendering. Dadurch werden beispielsweise eine interne Wiki-Seite oder ein kostenpflichtiger Artikel korrekt indexiert. Ihr Server benötigt dafür niemals die Zugangsdaten. Gleichzeitig kommt alles, was Sie aufrufen, als Kandidat für den Index infrage. Deshalb werden Ausschlussregeln vor weiteren Inhalten eingerichtet.

Ausschlussregeln befinden sich bei einer Einzelbenutzerinstallation in rules.json oder benutzerbezogen in der Datenbank. Der Tab Rules in der Weboberfläche ist die einfachste Möglichkeit, sie zu bearbeiten. Es handelt sich um reguläre Go-Ausdrücke, die gegen die vollständige URL abgeglichen werden:

^https://mail\.example\.com
^https://bank\.example\.com

Ein Muster wie ^mail.example.com wird niemals abgeglichen, weil die geprüfte Zeichenfolge mit https:// beginnt. Ein abschließendes $ schlägt fehl, wenn nach der Normalisierung noch eine Query-String vorhanden ist. Es werden nur utm_*-Parameter entfernt. Daher kann /login$ auf https://example.com/login?utm_source=email passen, aber nicht auf https://example.com/login?auth=1.

Vorhandene Verläufe werden durch Lesen der Datenbank des Browsers importiert. Der Befehl muss daher auf dem Rechner ausgeführt werden, auf dem das Browserprofil liegt. Das ist Ihr Laptop und nicht der VPS. Installieren Sie dort dieselbe Binary und verweisen Sie sie auf den Server:

export HISTER_TOKEN='your-access-token'
hister import browser firefox -u https://hister.example.com -t "$HISTER_TOKEN"

Ein Import läuft als fortsetzbarer Job mit dem Namen browser-import-YYYY-MM-DD. Sie können ihn daher unterbrechen und später erneut starten. Bookmark-Dienste werden auf dieselbe Weise importiert. v0.17.0 unterstützt Linkwarden, Karakeep und Shaarli. v0.18.0 ergänzte Linkding, Readeck und Wallabag. v0.20.0 ergänzte Raindrop.io. Ein erneuter Import aus Linkwarden, Karakeep, Shaarli, Linkding, Readeck oder Wallabag ruft nur Einträge ab, die neuer sind als beim letzten Import.

Dateien auf dem Server werden indexiert, indem Sie Verzeichnisse in der Konfiguration angeben:

indexer:
  directories:
    - path: '/var/lib/hister/documents'
      filetypes: ['pdf', 'docx', 'md', 'txt']

PDF-, DOCX-, Markdown-, Org-mode- und gültige UTF-8-Textdateien werden als vollständiger Text eingelesen. Fotos und Videos stehen nicht auf dieser Liste. Für eine Bildersammlung benötigen Sie daher einen Server, der Gesichter, Orte und Daten statt Text indexiert. PhotoPrism und Immich werden für diese Aufgabe gewöhnlich miteinander verglichen. Eine einzelne Seite fügen Sie mit hister index https://example.com hinzu. Ganze Websites für andere Tools in bereinigten Text umzuwandeln, ist eine separate Aufgabe. Dafür verwendet man Self-hosted-Crawler, die Seiten in bereinigten Text umwandeln.

Die Suche basiert auf Feldern. Daher lohnt es sich, zehn Minuten in das Lesen der Abfragesprache zu investieren:

"connection reset" domain:github.com added:<30d
title:(wireguard|nftables) -tutorial sort:-visits

Das Feld sort: wurde mit v0.18.0 eingeführt. Lassen Sie es daher in der zweiten Abfrage unter v0.17.0 weg.

Einen Coding-Agent auf den eigenen Index über MCP ansetzen

MCP (Model Context Protocol) ist die Schnittstelle, über die ein Assistent Tools auf einem Server aufruft. Hister stellt die Schnittstelle unter POST /mcp unter derselben Basis-URL über den Streamable-HTTP-Transport bereit und bietet search, get_preview und get_history an. Für die Authentifizierung wird dasselbe Bearer-Token wie für den übrigen API-Zugriff verwendet. Wenn Tool-Aufrufe für Sie neu sind, ist das Schreiben einer kleinen Agentenschleife der schnellste Weg, um zu sehen, welche Daten ein Endpunkt wie dieser tatsächlich an einen Assistenten übergibt.

{
  "mcpServers": {
    "hister": {
      "url": "https://hister.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Ein X-Access-Token-Header funktioniert als Alternative zu Authorization.

Der Vorteil liegt darin, wonach der Agent sucht. Die offene Websuche liefert die Ergebnisse, die heute am besten ranken. Bei schnelllebiger Software handelt es sich dabei häufig um die Dokumentation einer Version, die Sie nicht einsetzen. Ihr eigener Index liefert die Seite, die Sie bereits gelesen und zum Aufbewahren ausgewählt haben. get_preview stellt die gespeicherte Kopie bereit. Dadurch bleibt die Antwort verfügbar, wenn die ursprüngliche Seite offline geht. Geben Sie dem Agent beide Quellen, wenn Sie zusätzlich öffentliche Ergebnisse benötigen: ein von SearXNG unterstütztes Browser-Such-Skill fügt das offene Web als separates Tool hinzu. Sobald Sie mehr als einen dieser Endpunkte betreiben, sollten Sie MCP-Server auf einem VPS hosten lesen, weil für jeden davon dasselbe Problem mit der öffentlichen Erreichbarkeit gilt.

Festplatte, Backups und Wartung

Die Dokumentation rechnet pro indexierter Seite mit etwa 100 KB einschließlich der komprimierten Vorschau. Einhunderttausend Seiten entsprechen daher ungefähr 10 GB. Es gibt kein Quota-System. Zwei Einstellungen werden häufig verwechselt: indexer.max_file_size_mb (standardmäßig 1 MiB) begrenzt die Größe einer einzelnen überwachten Datei, während server.max_batch_body_size (standardmäßig 40 MiB) eine einzelne Anfrage an die Batch-API begrenzt. Die zweite Einstellung wurde nach v0.17.0 eingeführt. v0.17.0 begrenzt eine Batch-Anfrage fest auf 5 MiB.

Das in app.directory angegebene Verzeichnis enthält index.db mit den sprachspezifischen Indexdateien, db.sqlite3 für Konten und Jobs, data/html/ für Vorschauen sowie rules.json. Für ein Backup müssen Sie den Dienst stoppen und eine Kopie dieses gesamten Verzeichnisses sowie der Konfigurationsdatei erstellen. hister export backup.json schreibt Dokumente für die Migration als JSON. Dies ist kein Server-Backup.

Zwei Wartungsbefehle sollten Sie kennen. hister reindex erstellt die Suchindizes neu. Das ist nach einer Änderung der Indexer-Einstellungen erforderlich. Wenn der Speicherverbrauch während eines großen Imports steigt, setzen Sie detect_languages: false im Abschnitt indexer und erstellen Sie die Indizes neu. hister cleanup entfernt verwaiste Vorschau- und Favicon-Dateien, die nach Löschvorgängen zurückgeblieben sind.

Löschen ist eine Abfrage. Führen Sie sie daher zuerst im Dry-Run-Modus aus:

hister delete 'domain:example.com' --dry --verbose

Eine gelöschte Seite wird wieder angelegt, wenn ein Collector sie weiterhin übermittelt. Fügen Sie daher die Skip-Regel hinzu, bevor Sie die Seite löschen.

Wenn Sie eine unveränderte Kopie von Hister für sich selbst betreiben, entstehen Ihnen daraus keine Verpflichtungen, weil die AGPLv3 die uneingeschränkte Berechtigung zum Ausführen des unveränderten Programms bestätigt. Das Weitergeben von Kopien an andere Personen, unabhängig davon, ob sie geändert wurden, ist an Bedingungen geknüpft. Dazu gehören die unveränderte Beibehaltung der Urheberrechts- und Lizenzhinweise sowie die Weitergabe einer Kopie der Lizenz an die Empfänger. Wenn Sie Hister ändern und anderen Personen erlauben, Ihre Version über ein Netzwerk zu verwenden, müssen Sie ihnen gemäß der Lizenz außerdem den geänderten Quellcode anbieten.

Fehlerbilder und die angezeigten Zeichenfolgen

Der Server startet nicht. Ein belegter Port 4433 oder ein YAML-Syntaxfehler sind zwei mögliche Ursachen. Auch die Konfigurationsprüfung und der Zugriff auf das Datenverzeichnis können den Start verhindern. Das Binden an 0.0.0.0 ohne server.base_url erzeugt base_url must be specified when listening on. Wenn der geheime Schlüssel nicht geschrieben werden kann, wird failed to create secret key file erzeugt. sudo ss -lntp | grep 4433 zeigt, welcher Prozess den Port belegt. journalctl -u hister -n 50 --no-pager gibt den Startfehler aus.

Die Oberfläche wird geladen, sieht aber fehlerhaft aus. Bei vermischtem Text und fehlenden Bildern prüfen Sie das Pfadpräfix in server.base_url. Hister entfernt einen abschließenden Schrägstrich aus dieser Einstellung.

Die Erweiterung stellt keine Verbindung her. Die Server-URL in der Erweiterung muss base_url entsprechen. Der Server muss laufen und aktuell sein. Eine dazwischengeschaltete Firewall kann die Verbindung ohne Meldung auf der Seite blockieren. Firefox schreibt Erweiterungsprotokolle nicht in die normale Konsole. Öffnen Sie about:debugging#/runtime/this-firefox und prüfen Sie die Hister-Erweiterung.

Der Container wird beim Start beendet. Ein Berechtigungsfehler bei ./data erfordert die Prüfung von Eigentümer, Schreibberechtigungen und SELinux-Label. Diese Compose-Datei führt den Container ausdrücklich mit UID 1000 und GID 1000 aus und überschreibt damit die Standard-UID und -GID 65532 des Images. Geben Sie diesem Konto Schreibzugriff auf ./data. Fügen Sie bei einem SELinux-Host :Z in den Bind-Mount ein.

403 Forbidden bei einer Admin-Route. POST /api/reindex und POST /api/cleanup sind bei aktivierter Benutzerverwaltung nur für Administratoren verfügbar. Ein normales Konto wird dort daher abgewiesen.

Der Speicherverbrauch steigt während eines Imports. Üblicherweise ist die Spracherkennung über einer großen Historie die Ursache. Setzen Sie detect_languages: false und führen Sie anschließend hister reindex aus.

FAQ

Wie unterscheidet sich Hister von SearXNG?

SearXNG ist ein Metasuch-Proxy: Es leitet Ihre Anfrage an öffentliche Suchmaschinen weiter und gibt deren Ergebnisse ohne Tracking zurück. Der Index gehört daher diesen Suchmaschinen. Hister verwaltet einen eigenen Volltextindex der von Ihnen besuchten Seiten und gespeicherten Dateien. Hister beantwortet die Frage „Wo habe ich das gelesen?“, während SearXNG beantwortet, „Was sagt das Web?“. Die beiden Systeme lösen unterschiedliche Probleme. Viele Nutzer betreiben beide auf einem Server.

Ist es sicher, meinen vollständigen Browserverlauf auf einem VPS zu speichern?

Erst, wenn Sie die erforderlichen Schutzmaßnahmen umgesetzt haben. Hister bindet standardmäßig an 127.0.0.1:4433 und erfordert keine Authentifizierung. Setzen Sie app.access_token oder user_handling: true, schalten Sie einen Reverse Proxy mit TLS davor und halten Sie Port 4433 in der Firewall geschlossen. Ein Volltextindex Ihrer gelesenen Inhalte liegt als Klartext vor. Jeder, der den Port erreicht, kann daher alles lesen, ohne etwas knacken zu müssen.

Benötige ich die Browsererweiterung, oder kann ich einfach meinen Verlauf importieren?

Der Import ist eine einmalige Nachbefüllung. Er liest die Verlaufdatenbank des Browsers und läuft daher auf dem Computer, auf dem das Browserprofil liegt, nicht auf dem Server. Die Erweiterung hält den Index anschließend aktuell. Sie erfasst auch Seiten hinter einer Anmeldung, weil sie den Inhalt nach dem Rendern der Seite im Browser extrahiert. Ein gängiger Ablauf ist ein einmaliger Import, gefolgt von der Erweiterung.

Kann ein Coding-Agent meinen Hister-Index durchsuchen?

Ja. Hister ist ein MCP-Server (Model Context Protocol) unter POST /mcp auf Ihrer Basis-URL. Er stellt search, get_preview und get_history bereit. Richten Sie den Client auf https://your-host/mcp und übergeben Sie einen Authorization: Bearer-Header mit Ihrem Zugriffstoken. Der Agent durchsucht dann die Dokumentation, die Sie tatsächlich gelesen haben, in der von Ihnen gelesenen Version. Er verwendet nicht einfach die Ergebnisse, die heute in einer öffentlichen Suchmaschine weit oben stehen.

War dieser Artikel hilfreich?