Benutzerhandbuch

Installation

Wähle das passende Asset auf der Download-Seite und prüfe es vor dem Öffnen gegen SHA256SUMS. Diese Anleitung beschreibt die 1.0-Auslieferung; Muster-URLs sind keine Freigabe eines Builds. Mindestens 4 GB RAM, SSD und für größere Crawls 8–16 GB RAM empfohlen.

macOS: DMG und erster Start

Ab macOS 13: ein Universal-DMG für Apple Silicon und Intel. DMG öffnen, OpenSpider nach „Programme“ ziehen, DMG auswerfen und OpenSpider aus „Programme“ starten. Die CLI liegt unter /Applications/OpenSpider.app/Contents/MacOS/openspider.

Bei einem signierten und notarisierten Release kann Gatekeeper beim ersten Start die Bestätigung verlangen, dass die aus dem Internet geladene App geöffnet werden soll. Prüfe Quelle und angezeigten Entwickler. Bei „beschädigt“, unbekanntem Entwickler oder einer nicht prüfbaren Signatur nicht die Schutzprüfung abschalten, sondern den Build melden. Ein Freigabe-Build muss diese Prüfung bestehen.

Windows: NSIS, MSI und SmartScreen

Windows 10 ab 1809 oder Windows 11 x64; auf Windows on ARM läuft x64 unter Emulation. EXE/NSIS installiert für den aktuellen Nutzer ohne Administratorrechte; MSI installiert pro Rechner mit Administratorrechten. Beide enthalten die CLI openspider.exe. WebView2 wird geprüft und bei Bedarf heruntergeladen; dafür ist Internetzugang erforderlich. Neue Terminals übernehmen den PATH-Eintrag.

Signierte Release-Builds werden über Azure Artifact Signing signiert. SmartScreen kann bei geringer Reputation trotzdem warnen. Unter „Weitere Informationen“ den verifizierten Herausgeber prüfen und mit den Angaben des freigegebenen Releases vergleichen; eine Warnung allein bedeutet nicht, dass die Signatur ungültig ist. Bei unbekanntem Herausgeber oder ungültiger Signatur abbrechen und melden. Der verifizierte Herausgeber wird mit dem ersten signierten Release hier genannt.

Stille Installation, Beispiele für lokal heruntergeladene Dateien: In den folgenden Befehlen den tatsächlichen Asset-Namen einsetzen. MSI in einer erhöhten Eingabeaufforderung ausführen; bei NSIS muss /D zuletzt stehen, auch bei Leerzeichen ohne Anführungszeichen.

OpenSpider-setup.exe /S /D=C:\Tools\OpenSpider
msiexec /i OpenSpider.msi /qn /norestart INSTALLDIR="C:\Program Files\OpenSpider" ADDTOPATH=1

NSIS ergänzt den Benutzer-PATH. MSI ergänzt den Rechner-PATH bei der Erstinstallation mit ADDTOPATH=1; Upgrades übernehmen die vorhandene Auswahl.

Homebrew und winget: geplant

Homebrew-Cask und winget-Verteilung sind geplant und noch nicht verfügbar. Derzeit DMG oder Windows-Installer verwenden; es gibt hier noch keinen freigegebenen Paketmanager-Befehl.

JavaScript-Rendering und Chromium

Chromium ist nicht im Installer enthalten. Ohne JavaScript-Rendering ist kein zusätzlicher Browser erforderlich. Der derzeitige Rückfall ist installiertes Chrome/Chromium oder ein expliziter Pfad über rendering.chromium_path beziehungsweise OPENSPIDER_CHROMIUM.

Für 1.0 ist Chrome for Testing als Download auf Anfrage in den App-Datenordner vorgesehen, mit fester Version und SHA-256-Prüfung. Diese Bereitstellung ist noch nicht freigegeben. Die vorhandene CLI bietet bereits openspider --install-browser als separaten Browser-Download; dieser entspricht noch nicht der vorgesehenen Bereitstellung für 1.0. Lighthouse nutzt separat vorhandenes Node/Lighthouse.

Updates und Datenschutz

Hilfe → „Nach Updates suchen“ prüft manuell. „Automatisch nach Updates suchen“ unter Einstellungen → Updates ist standardmäßig an: beim Start höchstens einmal in 24 Stunden. Die Update-Prüfung überträgt nur Version, Betriebssystem und Architektur, keine Nutzerkennung und keine Crawl-Daten. Sie ist keine Telemetrie. GitHub Releases stellt das Manifest bereit; GitHub sieht dabei technisch die IP-Adresse. Optionale Integrationen und aufgerufene Websites sind eigene Netzwerkverbindungen.

Zum Abschalten die Einstellung deaktivieren oder in settings.toml setzen:

[updates]
check = false

Alternativ OpenSpider mit OPENSPIDER_DISABLE_UPDATE_CHECK=1 in der Prozessumgebung starten. Abgeschaltet erfolgt kein Zugriff auf den Update-Server. Die Einstellung gehört zur App, nicht zum Crawl-Profil. Offline oder nach fünf Sekunden Timeout wird beim Start nur protokolliert.

Updates können nach deiner Bestätigung im Hintergrund geladen werden; Release-Notes sind sichtbar. Die App bietet „Jetzt installieren und neu starten“, „Beim Beenden installieren“ und während eines Crawls „Nach Crawl-Ende installieren“. Ein laufender Crawl wird nicht erzwungen neu gestartet. HTTPS und gültige Update-Signaturen sind erforderlich; Downgrades werden abgelehnt. Die mitgelieferte CLI und registrierte Aufgaben werden mit aktualisiert. Eine separat installierte CLI aus einem Archiv ersetzt du selbst.

Bis 1.0 sind Betas normale GitHub-Releases mit latest.json und latest-beta.json. Es gibt keine Kanalwahl in der Oberfläche. Details zur Teilnahme stehen auf der Beta-Seite.

CLI und Linux

Linux x86_64 mit glibc unterstützt Kern und CLI, einschließlich MCP über STDIO. Linux-Desktop, .deb/.rpm und Linux-arm64-Releases sind nicht unterstützt. Das Linux-Archiv entpacken und die enthaltene Datei openspider ausführen; die glibc-Kompatibilität richtet sich nach dem Release-Build, kein musl-Build. Lizenzen im Archiv mitführen.

./openspider --version
./openspider --crawl https://example.com --headless --output-folder ./out --export-tabs "Internal:All" --save-crawl
./openspider --help
./openspider --check-update

Auf macOS den oben genannten vollständigen CLI-Pfad verwenden oder eine eigene Verknüpfung im PATH anlegen. Unter Windows in einem neuen Terminal openspider.exe verwenden. Die CLI prüft nie automatisch auf Updates; --check-update liefert Exit 0 für aktuell und 10 für ein verfügbares Update.

Zeitplanung

In der App eine Aufgabe mit Quelle, Zeitplan und Exportziel anlegen und aktivieren. macOS verwendet LaunchAgents, Windows die Aufgabenplanung; der Rechner muss zur Ausführung verfügbar sein. Der Planer ruft die gebündelte CLI auf. Ein vorhandener Aufgabenbezeichner kann mit openspider --run-task <ID> ausgeführt werden. Geplante Läufe prüfen nicht auf Updates. Unter Linux die CLI über den eigenen cron-/systemd-Planer mit absoluten Pfaden starten; keine Linux-App-Zeitplanung wird zugesagt.

MCP einrichten

Im MCP-Dialog der App den gewünschten Client und Transport wählen. STDIO startet eine CLI pro Verbindung; lokales HTTP erfordert die laufende App und Authentifizierung. Die Konfiguration kann auch mit der CLI erzeugt werden:

openspider mcp --print-config claude-code
openspider mcp --print-config codex
openspider mcp --print-config cursor
openspider mcp --print-config claude-desktop

Die ausgegebene Konfiguration in den jeweiligen Client übernehmen, den CLI-Pfad bei Bedarf auf den absoluten Installationspfad setzen und neu verbinden. Standardmäßig sind nur lesende Werkzeuge freigegeben. Weitere Werkzeugklassen bewusst freigeben. Tokens und Diagnosepakete nicht öffentlich teilen.

Deinstallation und Benutzerdaten

Vorher wichtige Crawl-Dateien sichern und die App schließen. macOS: zuerst "/Applications/OpenSpider.app/Contents/MacOS/openspider" --unregister-tasks ausführen, dann OpenSpider aus „Programme“ entfernen. Das Löschen der App allein entfernt keine LaunchAgents. Benutzerdateien bleiben erhalten.

Windows: über „Installierte Apps“ entfernen oder still deinstallieren:

C:\Tools\OpenSpider\uninstall.exe /S
msiexec /x OpenSpider.msi /qn /norestart

Benutzerdaten bleiben standardmäßig erhalten. Zum bewussten Löschen NSIS mit /REMOVEUSERDATA=1 oder MSI mit REMOVEUSERDATA=1 ergänzen. Die Installer entfernen Programmdateien, Startmenü, eigenen PATH-Eintrag und Aufgaben; Fehler bei der Aufgabenbereinigung im Protokoll prüfen. Gelöscht werden mit der Option nur die Standardordner des ausführenden Nutzers unter %APPDATA%\OpenSpider und %LOCALAPPDATA%\OpenSpider, keine fremden Profile, extern gespeicherten Crawls oder OPENSPIDER_HOME-Ordner.

macOS-Daten liegen unter ~/Library/Application Support/OpenSpider/, Logs unter ~/Library/Logs/OpenSpider/, Cache unter ~/Library/Caches/OpenSpider/. Diese nach Sicherung bei Bedarf selbst entfernen. Unter Linux liegen Einstellungen unter $XDG_CONFIG_HOME/OpenSpider (Standard ~/.config), Daten unter $XDG_DATA_HOME/OpenSpider (Standard ~/.local/share), Cache unter $XDG_CACHE_HOME/OpenSpider (Standard ~/.cache). Eigene cron-/systemd-Einträge und die CLI selbst entfernen. Bei gesetztem OPENSPIDER_HOME liegen Einstellungen, Crawls, Logs und Cache dort. Externe Crawl-Dateien und Client-Konfigurationen separat entfernen.