Installation unter Linux

Diese Anleitung beschreibt, wie Sie SetFN SpaceBuilder direkt auf einem Linux-Host ausführen. Die folgenden Beispiele beziehen sich auf Distributionen der Ubuntu-Familie; bei anderen Distributionen können Paketnamen und Installationsbefehle abweichen.

Bevor Sie beginnen

• sudo-Rechte für die Paketinstallation und die Einrichtung des automatischen Starts
• Ausreichend Speicherplatz für die Dienstdaten und die künftig hochgeladenen Dateien
• Firewall-Freigabe für den Serverport, wenn der Zugriff von anderen Geräten erfolgen soll

Für die Ausführung von SpaceBuilder sind keine sudo-Rechte erforderlich. Führen Sie das Programm mit einem normalen Benutzerkonto aus.

GPU-Server und KI-Workstations

Neben gewöhnlichen Linux-PCs und -Servern lassen sich auch GB10-basierte persönliche KI-Systeme wie NVIDIA DGX Spark, ASUS Ascent GX10, Dell Pro Max with GB10, HP ZGX Nano AI Station, Lenovo ThinkStation PGX und MSI EdgeXpert als Linux-Host verwenden. Diese Geräte eignen sich für GPU-gestützte Aufgaben wie das Ausführen lokaler KI-Modelle und die Wissensindexierung.

CPU-Architektur, Linux-Distribution, NVIDIA-Treiber und der Umfang der KI-Laufzeitunterstützung unterscheiden sich je nach Gerät. Prüfen Sie vor der Installation, ob die SpaceBuilder-Installationsdatei und die vorgesehene KI-Laufzeitumgebung die jeweilige Umgebung unterstützen.

Vollständige Schnellinstallation (in Vorbereitung)

Installationsdatei herunterladen

Laden Sie die Linux-Installationsdatei von der Download-Seite herunter.

Machen Sie die heruntergeladene Datei ausführbar.

chmod +x ~/setfn-spacebuilder

Erforderliche Bibliotheken installieren

SpaceBuilder nutzt für die Bildanalyse und die Erstellung von Vorschauen Programme (Bibliotheken), die auf dem Computer installiert sind. Installieren Sie unter Ubuntu 24.04 oder neuer zunächst die folgenden Pakete.

sudo apt update
sudo apt install -y \
  libvips42t64 libvips-tools \
  libheif1 libheif-plugin-libde265 \
  libglib2.0-0

Empfohlene Funktionspakete installieren

Der SpaceBuilder-Server übernimmt auch OCR, PDF-Analyse, Dokumentvorschau und Formatkonvertierung hochgeladener Dateien selbst. Die Grundfunktionen des Servers laufen auch ohne die folgenden Pakete, bei der Verarbeitung der betreffenden Dateien sind jedoch einige Funktionen eingeschränkt oder es stehen weniger Konvertierungs-Engines zur Verfügung.

Um alle OCR- und Dokumentkonvertierungsfunktionen zu nutzen, empfiehlt es sich, die folgenden Pakete zusammen zu installieren.

sudo apt install -y \
  tesseract-ocr tesseract-ocr-kor tesseract-ocr-jpn \
  poppler-utils \
  libreoffice pandoc

Den Installationsstatus können Sie mit den folgenden Befehlen prüfen.

vips --version
vips list classes | grep -i heif
tesseract --version
tesseract --list-langs
pdftotext -v
libreoffice --version
pandoc --version

Installationsprogramm ausführen

Führen Sie die Installationsdatei aus.

./setfn-spacebuilder

Das Installationsprogramm öffnet die Seite für die Ersteinrichtung standardmäßig auf Port 18510. Wird dieser Port bereits von einem anderen Programm verwendet, wird automatisch der nächste freie Port gewählt; verwenden Sie daher immer die im Terminal ausgegebene Adresse.

Sobald die Seite für die Ersteinrichtung im Browser geöffnet ist, lesen Sie die Nutzungsbedingungen, stimmen Sie ihnen zu und konfigurieren Sie das Administratorkonto und die Dienstumgebung. Details zu den Eingabefeldern und Hinweise finden Sie unter Ersteinrichtung.

Automatisch beim Einschalten des Computers starten

Nach Abschluss der Ersteinrichtung empfiehlt es sich, den automatischen Start einzurichten, damit SpaceBuilder dauerhaft läuft. Mit eingerichtetem automatischem Start gilt Folgendes:

• SpaceBuilder läuft weiter, auch wenn Sie das Terminal schließen, aus dem es gestartet wurde.
• SpaceBuilder startet automatisch, wenn Sie den Computer aus- und wieder einschalten.
• Wird SpaceBuilder durch einen Fehler beendet, startet es automatisch neu.

Unter Linux werden dauerhaft laufende Programme bei der Standard-Verwaltungsfunktion systemd registriert. Führen Sie dazu die folgenden Befehle der Reihe nach aus.

1. Eigenen Benutzernamen und Dateipfad ermitteln

Führen Sie die folgenden beiden Befehle jeweils einzeln aus.

whoami

realpath ~/setfn-spacebuilder

• whoami zeigt den Namen des aktuell angemeldeten Benutzers an.
• realpath zeigt den genauen Speicherort der ausführbaren SpaceBuilder-Datei an.

Notieren Sie sich die Ausgabe, da Sie sie im nächsten Schritt benötigen.

2. Konfigurationsdatei für den automatischen Start erstellen

Falls SpaceBuilder derzeit im Terminal läuft, beenden Sie es zuerst mit Ctrl+C. Öffnen Sie die Konfigurationsdatei für den automatischen Start mit folgendem Befehl.

sudo nano /etc/systemd/system/setfn-spacebuilder.service

Fügen Sie den folgenden Inhalt ein. Ersetzen Sie jedes <Benutzer> durch den in Schritt 1 ermittelten Benutzernamen und tragen Sie bei ExecStart den ermittelten Pfad der ausführbaren Datei ein.

[Unit]
Description=SetFN SpaceBuilder
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=<Benutzer>
WorkingDirectory=/home/<Benutzer>
Environment=HOME=/home/<Benutzer>
ExecStart=/home/<Benutzer>/setfn-spacebuilder
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

In nano speichern Sie mit Ctrl+O und Enter und beenden anschließend mit Ctrl+X.

3. Automatischen Start aktivieren

Führen Sie die folgenden Befehle jeweils einzeln aus. Der erste Befehl macht Linux die erstellte Konfiguration bekannt; der zweite startet SpaceBuilder sofort und sorgt dafür, dass es ab dem nächsten Systemstart automatisch gestartet wird.

sudo systemctl daemon-reload

sudo systemctl enable --now setfn-spacebuilder

Prüfen Sie, ob der Dienst ordnungsgemäß läuft.

systemctl status setfn-spacebuilder

Wird active (running) angezeigt, ist der automatische Start eingerichtet. Mit q können Sie die Statusanzeige schließen.

4. Ursache ermitteln, wenn der Dienst nicht läuft

Wird active (running) nicht angezeigt oder ist SpaceBuilder nicht erreichbar, prüfen Sie die letzten Protokolleinträge mit folgendem Befehl.

journalctl -u setfn-spacebuilder -n 100 --no-pager

Um den Startvorgang in Echtzeit zu verfolgen, verwenden Sie den folgenden Befehl. Beenden Sie die Anzeige anschließend mit Ctrl+C.

journalctl -u setfn-spacebuilder -f

Befehle zur Verwaltung des automatischen Starts

Wenn Sie den Inhalt der Konfigurationsdatei für den automatischen Start geändert haben, führen Sie sudo systemctl daemon-reload aus und starten Sie SpaceBuilder anschließend neu, damit die Änderungen wirksam werden.

Wie Sie Konten oder Zugriffsbeschränkungen wiederherstellen, wenn Sie sich nicht auf der Administrationsseite anmelden können, erfahren Sie unter Server über Befehle verwalten.