Mkdocs wiki web serving

---\ntitle: MkDocs Wiki Web Serving\ncreated: 2026-04-08\nupdated: 2026-04-08\ttype: concept\ntags: [mkdocs, documentation, web-server, nginx, static-site]\nsources: []\n---\n\n# MkDocs Wiki Web Serving\n\n## Überblick\nDieses Konzept beschreibt, wie eine mit MkDocs erstellte Dokumentation (wie dieses LLM-Wiki) über einen Webserver bereitgestellt wird. Es umfasst den Build-Prozess, das Hosting statischer Dateien und die Konfigurierung von nginx als Reverse-Proxy oder Webserver.\n\n## Voraussetzungen\n- Installiertes MkDocs mit Material-Theme (mkdocs und mkdocs-material via pip)\n- Eine MkDocs-Konfiguration (mkdocs.yml)\n- Webserver (nginx empfohlen) oder Zugang zu einem Hosting-Dienst\n- Grundlegende Kenntnisse in Linux-Systemverwaltung\n\n## Build-Prozess\nDie Dokumentation wird mit folgendem Befehl gebaut:\n\nbash\nmkdocs build --config-file /pfad/zu/mkdocs.yml\n\n\nDies generiert eine statische Website im site/ Verzeichnis (oder wie in der Konfiguration angegeben).\n\nIn diesem Setup wird das Skript /root/update-wiki.sh verwendet, das:\n1. mkdocs build mit der angegebenen Konfigurationsdatei ausführt\n2. Zusatzdateien kopiert (wie das benutzerdefinierte network.html und graph-data.json)\n3. Berechtigungen für den Webserver-Benutzer setzt\n\n## Nginx-Konfiguration für statisches Hosting\nEine einfache nginx-Konfiguration zum Servieren der generierten Seite:\n\nnginx\nserver {\n listen 80;\n server_name wiki.masterppp.net;\n \n root /var/www/wiki-site;\n index index.html;\n \n location / {\n try_files $uri $uri/ =404;\n }\n \n # Optional: Sicherheitsheaders\n add_header X-Content-Type-Options nosniff;\n add_header X-Frame-Options SAMEORIGIN;\n add_header X-XSS-Protection \"1; mode=block\";\n \n # Optional: Komprimierung aktivieren\n gzip on;\n gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;\n}\n\n# HTTPS-Weiterleitung\nserver {\n listen 443 ssl;\n server_name wiki.masterppp.net;\n \n ssl_certificate /etc/letsencrypt/live/wiki.masterppp.net/fullchain.pem;\n ssl_certificate_key /etc/letsencrypt/live/wiki.masterppp.net/privkey.pem;\n \n root /var/www/wiki-site;\n index index.html;\n \n location / {\n try_files $uri $uri/ =404;\n }\n \n # Sicherheitsheaders wie oben\n add_header X-Content-Type-Options nosniff;\n add_header X-Frame-Options SAMEORIGIN;\n add_header X-XSS-Protection \"1; mode=block\";\n \n gzip on;\n gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;\n}\n\n\n## Automatisierte Updates\nUm das Wiki aktuell zu halten, kann ein Cron-Job eingerichtet werden, der das Update-Skript in regelmäßigen Abständen ausführt:\n\nbash\n# Alle 30 Minuten aktualisieren\n*/30 * * * * /root/update-wiki.sh\n\n\n## Siehe auch\n- hermes-ai-agent — Der KI-Agent der dieses Wiki pflegen kann\n- openclaw-gateway-setup — Für den Zugriff auf verwandte Dienste\n- install-openclaw — Installation der OpenClaw AI\n\n---\nLetzte Änderung: 2026-04-08