Schnellstart-Anleitung

Fess in unter 5 Minuten zum Laufen bringen

Willkommen! Diese Anleitung hilft Ihnen, Fess so schnell wie möglich zum Laufen zu bringen. Wählen Sie die Methode, die am besten zu Ihrer Umgebung passt.

Tipp

Schnellster Weg: Docker (Empfohlen)

Wenn Sie Docker installiert haben, können Sie Fess in etwa 3 Minuten mit nur wenigen Befehlen starten – keine weiteren Abhängigkeiten erforderlich.

Methode 1: Docker (Empfohlen)

Docker bietet den schnellsten und zuverlässigsten Weg, Fess auszuführen. Alle Abhängigkeiten sind gebündelt, sodass Sie nichts anderes installieren müssen.

Voraussetzungen:

  • Docker 20.10 oder neuer

  • Docker Compose 2.0 oder neuer

Schritt 1: Konfigurationsdateien herunterladen

mkdir fess-docker && cd fess-docker
curl -OL https://raw.githubusercontent.com/codelibs/docker-fess/master/compose/compose.yaml
curl -OL https://raw.githubusercontent.com/codelibs/docker-fess/master/compose/compose-opensearch3.yaml

Schritt 2: Container starten

docker compose -f compose.yaml -f compose-opensearch3.yaml up -d

Schritt 3: Auf Fess zugreifen

Warten Sie einige Minuten, bis die Dienste initialisiert sind, und öffnen Sie dann Ihren Browser:

Warnung

Sicherheitshinweis: Ändern Sie das Standard-Admin-Passwort sofort nach Ihrer ersten Anmeldung.

Fess stoppen:

docker compose -f compose.yaml -f compose-opensearch3.yaml down

Für erweiterte Docker-Konfiguration (benutzerdefinierte Einstellungen, externes OpenSearch, Kubernetes) siehe die Docker-Installationsanleitung.

Methode 2: ZIP-Paket

Wenn Sie Docker nicht verwenden möchten, können Sie Fess direkt aus dem ZIP-Paket ausführen.

Bemerkung

Diese Methode ist für Evaluierungszwecke gedacht. Für Produktionsumgebungen empfehlen wir Docker oder die Installation mit RPM/DEB-Paketen.

Voraussetzungen

Java 21 ist erforderlich. Wir empfehlen Eclipse Temurin.

Überprüfen Sie Ihre Java-Installation:

java -version

Download und Installation

  1. Laden Sie das neueste ZIP-Paket von GitHub Releases herunter

  2. Entpacken Sie es und wechseln Sie in das Verzeichnis:

unzip fess-15.5.0.zip
cd fess-15.5.0

Fess starten

# Linux/Mac
./bin/fess

# Windows
bin\fess.bat

Warten Sie etwa 30 Sekunden, bis Fess gestartet ist, und greifen Sie dann zu auf:

Fess stoppen

Drücken Sie Strg+C im Terminal oder verwenden Sie kill, um den Fess-Prozess zu beenden.

Ihre erste Suche: Ein kurzes Tutorial

Jetzt, da Fess läuft, richten wir Ihren ersten Web-Crawl ein.

Schritt 1: Web-Crawl-Konfiguration erstellen

  1. Melden Sie sich im Admin-Bereich an (http://localhost:8080/admin)

  2. Navigieren Sie zu Crawler → Web im linken Menü

  3. Klicken Sie auf Neu, um eine neue Konfiguration zu erstellen

  4. Füllen Sie die erforderlichen Felder aus:

    • Name: Mein erster Crawl

    • URL: https://fess.codelibs.org/ (oder eine beliebige Website, die Sie indexieren möchten)

    • Max. Zugriffe: 100 (begrenzt die zu crawlenden Seiten)

    • Intervall: 1000 (Millisekunden zwischen Anfragen)

  5. Klicken Sie auf Erstellen, um zu speichern

Schritt 2: Crawler ausführen

  1. Gehen Sie zu System → Scheduler

  2. Finden Sie Default Crawler in der Liste

  3. Klicken Sie auf Jetzt starten

  4. Überwachen Sie den Fortschritt unter System → Crawl-Informationen

Schritt 3: Ihre Inhalte durchsuchen

Sobald das Crawling abgeschlossen ist (prüfen Sie WebIndexSize in den Sitzungsinformationen):

  1. Besuchen Sie http://localhost:8080/

  2. Geben Sie einen Suchbegriff ein, der sich auf die gecrawlten Seiten bezieht

  3. Sehen Sie Ihre Suchergebnisse!

Was kommt als Nächstes?

Bereit, tiefer einzusteigen?

Brauchen Sie Hilfe?

Weitere Funktionen entdecken:

  • Dateisystem-Crawling (lokale Dateien, Netzwerkfreigaben)

  • Datenbankintegration

  • LDAP/Active Directory-Authentifizierung

  • Benutzerdefiniertes Ranking der Suchergebnisse

  • Mehrsprachige Unterstützung