Installation
Voraussetzungen, Installation und Ersteinrichtung des oPBWeb-Stacks
Zielgruppe: Technische Administration
Überblick
oPBWeb läuft als Docker-Compose-Stack auf einem Linux-Host, der den opsi-Configserver erreicht. Der Stack besteht aus diesen Diensten:
| Dienst | Aufgabe |
|---|---|
| frontend | nginx mit der Weboberfläche und diesem Handbuch, einziger nach außen offener Dienst |
| api | REST-API (FastAPI), Anmeldung, Datenbankmigrationen |
| worker | Hintergrundjobs: Bauen, Installieren, Depot-Abgleich, Verbindung zum opsi-Server |
| db | MariaDB für alle Anwendungsdaten |
| redis | Job-Warteschlange und Statusinformationen |
| garage | S3-kompatibler Objektspeicher für Paketdateien und gebaute Pakete |
Die Installation übernimmt die technische Administration: Host vorbereiten, Konfiguration und Secrets anlegen, Stack starten. Die anschließende Ersteinrichtung in der Oberfläche (opsi-Server, Depots, Benutzer) erledigt ein Benutzer mit der Rolle Administrator.
Kapitel
- Voraussetzungen – Host, Docker, Ports, Netzwerk zum Configserver, opsi-seitige Vorbereitung und Versionen.
- Installation
– Quellen holen,
.envund Secrets anlegen, TLS-Zertifikat einbinden, Stack starten und prüfen. - Ersteinrichtung – erste Anmeldung, Configserver einrichten, Depot-Stufen setzen, erste Benutzer anlegen.
- Testumgebung – oPBWeb ohne opsi-Server ausprobieren, mit zwei opsi-Mocks als Configserver Test und Produktion.
Für Konfiguration, LDAP, Betrieb und Sicherung im laufenden Betrieb siehe Technische Administration .