Installation unter Windows

Bevor Sie beginnen

• Windows 10 (Version 2004 oder neuer) oder Windows 11
• Ein Konto, mit dem Sie PowerShell als Administrator ausführen können
• Ausreichend Speicherplatz für die Dienstdaten und die künftig hochgeladenen Dateien

WSL und Ubuntu installieren

Wenn WSL bereits installiert ist, überspringen Sie diesen Schritt und fahren Sie mit SpaceBuilder installieren fort.

1. Führen Sie PowerShell als Administrator aus.
   Suchen Sie in der Windows-Suche nach PowerShell, klicken Sie mit der rechten Maustaste darauf und wählen Sie Als Administrator ausführen.
   
2. Es öffnet sich ein Terminalfenster wie dieses.
   
   Geben Sie den folgenden Befehl ein.

   wsl --install
   

   
   Dieser Befehl installiert WSL2 zusammen mit der Standarddistribution Ubuntu.
3. Starten Sie den Computer nach Abschluss der Installation neu.
4. Wenn sich nach dem Neustart automatisch das Ubuntu-Terminal öffnet, geben Sie den gewünschten Benutzernamen und das Passwort ein, um Ihr Ubuntu-Konto zu erstellen.
   Im Terminal wird Folgendes angezeigt.

   Installing, this may take a few minutes...
   Please create a default UNIX user account. The username does not need to match your Windows username.
   For more information visit: https://aka.ms/wslusers
   Enter new UNIX username:
   

   
   Geben Sie einen Benutzernamen ein und drücken Sie Enter. Anschließend werden nacheinander das Passwort (New password:) und dessen Bestätigung (Retype new password:) abgefragt. Nach Abschluss erscheint die Meldung Installation successful! zusammen mit der Ubuntu-Shell-Eingabeaufforderung (Benutzername@PC-Name:~$).
   Herzlichen Glückwunsch, Sie können jetzt Linux unter Windows verwenden. Lassen Sie das geöffnete Ubuntu-Terminal vorerst offen.

Linux überprüfen

Ob die Installation erfolgreich war, können Sie auch im Explorer prüfen. Wenn Sie den Explorer öffnen, finden Sie unten in der linken Seitenleiste den neuen Eintrag Linux.

Wenn Sie auf Linux klicken, erscheint der Ordner Ubuntu. Wechseln Sie darin in home, sehen Sie den Ordner mit dem soeben eingegebenen Benutzernamen.

Installationsdatei herunterladen und verschieben

1. Laden Sie die Installationsdatei für Linux (setfn-spacebuilder) von der Download-Seite herunter.
2. Wechseln Sie im Explorer in den zuvor geprüften Ordner Linux → Ubuntu → home → (der eben eingegebene Benutzername) und verschieben Sie die heruntergeladene Datei in diesen Ordner.
   

SpaceBuilder installieren

Die Ubuntu-Umgebung in WSL verhält sich wie eine gewöhnliche Linux-Umgebung. Da die Installationsdatei bereits verschoben wurde, beginnen Sie im Ubuntu-Terminal damit, sie mit folgendem Befehl ausführbar zu machen.

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.

Zugriff über den Windows-Browser

WSL2 teilt sich das Netzwerk mit Windows. Daher können Sie SpaceBuilder, auch wenn es in Ubuntu läuft, direkt über die Adresse http://localhost:18510 in einem Windows-Browser wie Chrome oder Edge aufrufen. Bei einem anderen Port verwenden Sie die im Ubuntu-Terminal ausgegebene Adresse unverändert.

Sobald die Seite für die Ersteinrichtung geöffnet ist, lesen Sie die Nutzungsbedingungen, stimmen Sie ihnen zu und konfigurieren Sie gemäß Ersteinrichtung das Administratorkonto und die Dienstumgebung.

Hinweise

• Wenn Sie das Ubuntu-Terminal schließen, wird auch SpaceBuilder beendet. Damit es auch nach dem Schließen des Terminals weiterläuft, richten Sie den automatischen Start mit systemd gemäß der Anleitung Automatisch starten ein. Um systemd in WSL zu verwenden, muss zuvor in /etc/wsl.conf im Abschnitt [boot] die Einstellung systemd=true gesetzt sein.
• Wenn Sie Windows herunterfahren oder neu starten, wird auch WSL beendet. Auch bei eingerichtetem automatischem Start mit systemd startet Windows WSL nicht automatisch neu; nach einem Neustart müssen Sie das Ubuntu-Terminal daher selbst öffnen, damit SpaceBuilder wieder startet.
• Für den Zugriff von anderen Geräten im selben Netzwerk müssen Sie zusätzlich die WSL-Netzwerkeinstellungen und die Windows-Firewallregeln prüfen.

WSL nach einem Windows-Neustart automatisch starten

Wenn Sie in der Aufgabenplanung eine Aufgabe registrieren, die WSL bei der Windows-Anmeldung automatisch ausführt, startet SpaceBuilder nach einem Neustart auch ohne manuelles Öffnen des Ubuntu-Terminals wieder. Der automatische Start mit systemd muss bereits eingerichtet sein.

1. Suchen Sie in der Windows-Suche nach taskschd.msc (oder Aufgabenplanung) und starten Sie das Programm.
2. Wählen Sie Aufgabe erstellen (verwenden Sie Aufgabe erstellen und nicht Einfache Aufgabe erstellen, damit Sie die detaillierten Optionen festlegen können).
3. Wählen Sie auf der Registerkarte Trigger die Option Neu, setzen Sie Aufgabe starten auf Bei Anmeldung und wählen Sie das zu verwendende Benutzerkonto aus.
4. Wählen Sie auf der Registerkarte Aktionen die Option Neu, geben Sie bei Programm/Skript den Wert wsl.exe ein und bei Argumente hinzufügen Folgendes:

-d Ubuntu -u <Benutzername> -- true

Ersetzen Sie <Benutzername> durch den Benutzernamen, den Sie beim Erstellen des Ubuntu-Kontos festgelegt haben. Dieser Befehl dient nur dazu, WSL zu booten und systemd zu starten; anschließend startet der zuvor aktivierte SpaceBuilder-Dienst automatisch.

Verwandte Dokumente

• Installation unter Linux
• Ersteinrichtung