DokuWiki¶
Was es tut¶
Das DokuWiki ist das Wiki des Vereins, mit einem öffentlichen Teil und einem internen Bereich nur für Mitglieder. Dort stehen Anleitungen für Maschinen, Abläufe im Verein und Wissen aus den Werkstätten.
Wo es liegt¶
| Adresse | https://wiki.garage-lab.de |
| Plattform | Webspace bei hosting.de; die Anwendung selbst betreiben wir |
| Software | DokuWiki |
| Im Repo | DNS-Eintrag in desec/desec_garage_lab_de.cue und die Anbindung an Authentik |
Verwaltet über¶
Web-Oberfläche. Inhalte, Plugins und Einstellungen pflegt man im Admin-Bereich des DokuWiki, den Webspace in der Web-Oberfläche von hosting.de. Im Repo steht nur die Anbindung an Authentik.
Aufbau¶
DokuWiki läuft in einem eigenen Paket bei hosting.de, getrennt von der Webseite. DokuWiki braucht keine Datenbank, es speichert alle Seiten als Dateien.
Login / SSO¶
Angemeldet wird über Authentik per OIDC, mit einem OAuth-Plugin im DokuWiki (application_dokuwiki.tf).
Neue Mitglieder kommen automatisch in die Gruppe „Dokuwiki Access“ und in die App-Gruppe „garagelabintern“, die den internen Bereich freigibt.
Das DokuWiki übernimmt Gruppen aus Authentik über den Claim groups, etwa editor oder admin; welche es gibt, steht unter dokuwiki in tf-groups/group_applications.tf.
Welche Rechte eine Gruppe im Wiki hat, ist im DokuWiki selbst eingestellt (siehe Gruppenmodell in Authentik).
Backup¶
Das DokuWiki sichern wir mit einem eigenen Skript, das bisher nicht im Repo liegt. Es ist nicht Teil des Backups der Hosts (siehe Backup).
Updates¶
DokuWiki und seine Plugins werden im Admin-Bereich des DokuWiki aktualisiert. Vor einem Update die Änderungen der neuen Version lesen.
Besonderheiten / bekannte Probleme¶
apps/dokuwiki/stack-dokuwiki.cuewar nur ein Proof of Concept, das DokuWiki selbst als Container zu betreiben. Es wird nicht ausgerollt, bleibt aber bewusst im Repo.
Entscheidungen¶
Das Wiki liegt beim Webhoster, nicht auf unseren Hosts. Ein DokuWiki braucht nichts, was ein gewöhnliches Webhosting nicht bietet, und um Betrieb und Server kümmert sich der Anbieter (siehe hosting.de).