Lektion 3: Ordnerstruktur & Webserver starten
Jetzt geht’s richtig los: In dieser Lektion starten wir den integrierten Webserver auf dem USB-Stick und rufen dein DokuWiki im Browser auf. Danach bist du bereit für die Erstinstallation.
1. Überblick: Ordner nach dem Entpacken
Nach dem Entpacken des offiziellen DokuWiki-Pakets für Windows findest du im Zielverzeichnis (z. B. `Downloads` oder direkt auf dem USB-Stick) folgende Struktur:
- server → Der integrierte Apache2 Mini-Webserver mit PHP
- dokuwiki → Das eigentliche DokuWiki-System
- run.cmd → Die Startdatei, um Webserver und Wiki gemeinsam zu starten
Diese Struktur ist speziell für den portablen Einsatz unter Windows vorkonfiguriert.
2. Lokalen Webserver starten
So startest du dein Wiki lokal im Browser:
- Doppelklicke auf die Datei `run.cmd`
- Es öffnet sich ein schwarzes Terminalfenster (Kommandozeile) mit dem Apache-Startprotokoll
- Öffne nun deinen Browser (z. B. Chrome oder Firefox)
- Gib in die Adresszeile ein:
→ http://127.0.0.1:8800/install.php
Dort startet der DokuWiki-Installationsassistent.
Falls der Port 8800 bereits von einer anderen Anwendung verwendet wird, kannst du ihn in der Konfiguration im `server\conf\httpd.conf` ändern.
3. DokuWiki einrichten: Schritt für Schritt
Folgende Felder solltest du ausfüllen:
- Wiki-Name – z. B. „Mein USB-Wiki“ oder „Offline Notizen“
- Admin-Benutzername – z. B. `admin`
- Passwort + Wiederholung – ein sicheres Kennwort wählen!
- E-Mail-Adresse – optional (für Passwort-Reset)
- Sprache – z. B. `Deutsch`
Du kannst auch Optionen wie Open Registration (Benutzer dürfen sich selbst registrieren) deaktivieren, da du vermutlich allein mit dem Stick arbeitest.
Dann klickst du auf: → Installation starten
4. Fehlermeldungen? Das kannst du tun:
Wenn das Startfenster sofort wieder geschlossen wird oder nichts passiert:
- Rechtsklick auf `run.cmd` → „Als Administrator ausführen“
- Stelle sicher, dass dein USB-Stick Schreibrechte hat
- Starte testweise vom lokalen Laufwerk (z. B. Desktop)
- Antivirenprogramm kann blockieren – Ausnahmeregel prüfen
Wichtig: Diese portable Version funktioniert nur unter Windows!
Für macOS oder Linux sind eigene Installationswege notwendig, z. B. über lokale Webserver wie MAMP oder XAMPP.
5. Was passiert beim ersten Aufruf?
Wenn alles funktioniert, öffnet sich im Browser automatisch die Seite:
→ install.php
Hier beginnt die einmalige Einrichtung deines DokuWikis. Mehr dazu erfährst du in der nächsten Lektion.
→ Weiter zu Lektion 4: DokuWiki installieren
minikurs dokuwiki usb lektion_03 ordnerstruktur webserver start run.cmd windows