Erste Schritte

Diese Anleitung richtet Fundus auf einem Windows-Rechner ein, ohne dass du dich mit Servern oder Programmierung auskennen musst, zum Ausprobieren auf dem eigenen Rechner. Am Ende läuft das Wiki mit Beispielinhalten, Handbuch und KI-Chat.

Für den Betrieb in einer Firma mit eigener Adresse, https und Anmeldung über Firmenkonten ist die IT zuständig; die Anleitung dafür steht in der Entwicklerdoku, Kapitel „Betrieb“. Wie man das Wiki benutzt, erklärt das Handbuch „So funktioniert das Wiki“, das Schritt 9 ins Wiki einspielt.

Das brauchst du#

Docker Desktop ist für Privatleute, Ausbildung und kleine Firmen kostenlos; größere Firmen brauchen eine Lizenz. Die genauen Grenzen stehen auf der Docker-Seite. Unter macOS und Linux geht es genauso; dort statt PowerShell das Terminal nehmen.

Schritt für Schritt#

1. Docker Desktop installieren#

Von der Docker-Seite Download for Windows laden und das Installationsprogramm ausführen. Die Vorgabe „Use WSL 2“ angehakt lassen. Danach den Rechner neu starten, Docker Desktop aus dem Startmenü öffnen und die Bedingungen bestätigen. Eine Anmeldung bei Docker ist nicht nötig, Skip genügt. Warten, bis unten links „Engine running“ steht.

2. Python installieren#

Von python.org die aktuelle Version für Windows laden und ausführen. Wichtig: Im ersten Fenster unten den Haken bei „Add python.exe to PATH“ setzen, dann Install Now.

3. Projekt entpacken#

Die ZIP-Datei von GitHub mit Rechtsklick → Alle extrahieren entpacken, zum Beispiel nach C:\Fundus. Darin liegt ein Ordner wie fundus-1.0.0; die Zahl am Ende ist die Version.

4. PowerShell im Ordner öffnen#

Diesen Ordner im Explorer öffnen, oben in die Adressleiste klicken, powershell tippen und Enter drücken. Es öffnet sich ein Fenster, das schon im richtigen Ordner steht. Alle weiteren Befehle tippst oder kopierst du in dieses Fenster.

5. Einstellungen anlegen#

python skripte\env-anlegen.py --lokal

Das legt die Datei .env mit zufälligen Passwörtern und Schlüsseln an. Die Meldung nennt zwei Werte, APP_KEY und SICHERUNG_KOPIE_SCHLUESSEL: Die Datei .env gut aufheben, ohne sie lässt sich eine Sicherung nicht zurückspielen.

6. Starten#

docker compose -p fundus -f docker-compose.yml -f docker-compose.lokal.yml up -d --build

Beim ersten Mal lädt Docker mehrere Gigabyte; das dauert je nach Leitung 15 bis 45 Minuten. Die Befehlszeile kommt zurück, sobald alles gestartet ist; die KI-Modelle laden danach im Hintergrund weiter.

In Docker Desktop unter Containers steht nun fundus mit mehreren Diensten. Alle sind grün (Running), nur ollama-modelle wechselt auf Exited, sobald die KI-Modelle geladen sind. Das ist richtig so.

7. Anmelden und Passwort ändern#

Im Browser http://localhost:6875 öffnen. Beim ersten Start dauert es ein bis zwei Minuten, bis die Anmeldeseite erscheint. Anmelden mit

• E-Mail: admin@admin.com
• Passwort: password

Sofort ändern: http://localhost:6875/settings/users öffnen, Admin anklicken, eigene E-Mail und ein neues Passwort eintragen, Speichern.

8. Zugangsschlüssel für die Einrichtung#

Auf derselben Seite (Admin unter http://localhost:6875/settings/users) weiter unten im Abschnitt API-Token auf Token erstellen. Als Name „Einrichtung“ eintragen, speichern. Angezeigt werden Token ID und Token Kennwort. Beide jetzt kopieren; das Kennwort wird nur dieses eine Mal angezeigt.

9. Wiki einrichten#

Im PowerShell-Fenster, die beiden Werte aus Schritt 8 zwischen die Anführungszeichen einsetzen:

$env:BOOKSTACK_URL = "http://localhost:6875"
$env:BOOKSTACK_TOKEN_ID = "Token ID hier einsetzen"
$env:BOOKSTACK_TOKEN_SECRET = "Token Kennwort hier einsetzen"
python skripte\einrichten.py --beispiele

Das legt Rollen, Bereiche, Themen, Vorlagen, das Handbuch, drei Beispielartikel und zwei Beispielkonten (Mia Mitarbeiterin, Alex Azubi, beide ohne Passwort) an. Rechne mit einer guten Viertelstunde, zwischendurch auch mit längeren Pausen ohne neue Zeile: Das Skript legt jeden Artikel einzeln an, und die KI nimmt ihn gleich in ihren Index auf. Solange kein Fehler kommt, läuft es.

Am Ende bittet das Skript um einen Handgriff, weil sich das Vorlagen-Häkchen nicht automatisch setzen lässt:

1. Im Wiki das Thema Vorlagen öffnen.
2. Jeden der genannten Artikel öffnen → Bearbeiten → rechts in der Seitenleiste Vorlagen → Haken bei Artikel ist eine Vorlage → Artikel speichern.
3. Den letzten Befehl noch einmal ausführen (Pfeil-nach-oben-Taste, Enter). Jetzt meldet es „Fertig.“

10. KI-Chat einschalten#

In Docker Desktop prüfen, dass ollama-modelle auf Exited steht. Dann einmal den Suchindex der KI über alle Artikel bauen:

docker exec -u abc -w /app/www fundus-wiki-1 php artisan fundus:ki-index

Danach unten rechts im Wiki auf Frag Fundus klicken und etwas fragen, zum Beispiel „Wie richte ich ein freigegebenes Postfach ein?“. Neue und geänderte Artikel nimmt die KI ab jetzt von selbst auf.

11. Aufräumen#

• Den API-Token aus Schritt 8 wieder löschen (gleiche Seite, Token öffnen → Lösche Token).
• Unter Einstellungen → Personalisierung den Namen des Wikis eintragen.
• Kollegen legst du unter http://localhost:6875/settings/users → Benutzer hinzufügen an und gibst ihnen eine Rolle (Mitarbeiter, Azubi, Redaktion …). Das Handbuch erklärt die Rollen im Kapitel „Rechte und Freigaben“. Nimm dabei den Haken bei Benutzer-Einladungs-E-Mail senden heraus und setze selbst ein Kennwort, das du der Person gibst. In dieser Einrichtung verschickt das Wiki keine E-Mails, die Einladung käme also nie an.

Andere Rechner im Netz erreichen das Wiki in dieser Einrichtung nicht: Sie ist bewusst nur auf diesem Rechner offen. Für ein Team mit eigener Adresse und https bitte die IT ansprechen (Entwicklerdoku, Kapitel „Betrieb“).

Später#

Wenn etwas nicht klappt#

Weitere Fragen: Issue anlegen.