Condui Community installieren und erstellen
Lokale Installation über Docker, Podman oder Quellcode.
Condui Community ist die selbst gehostete, lokale Ausgabe von Condui. Sie arbeitet ohne Konto, Datenbank oder verwalteten Condui-Dienst. Sie können den Quellcode selbst erstellen und die Anwendung auf Ihrem eigenen Computer oder Server ausführen.
Community speichert Projekte standardmäßig im Browser Ihres Geräts oder optional in einem Ordner auf Ihrem eigenen Server. Heruntergeladene Condui-Projektarchive sind in beide Richtungen mit der gehosteten Version kompatibel.
Quellcode von Condui Community auf GitHub ansehen.
Welche Installationsmethode wählen Sie?
| Methode | Geeignet für |
|---|---|
| Docker Compose | Die einfachste und empfohlene Installation |
| Podman | Eine Docker-kompatible Alternative ohne Docker Desktop |
| Node.js 24 | Anzeigen, Ändern und manuelles Erstellen des Quellcodes |
Das mitgelieferte Dockerfile erstellt ein OCI-Standardcontainerimage. Andere OCI-kompatible Containerwerkzeuge können das Image ebenfalls erstellen; getestet wurden Docker und Podman.
Voraussetzungen
Für Docker Compose oder Podman benötigen Sie:
- Git oder eine heruntergeladene Kopie des Repositorys;
- Docker mit dem Compose-Plugin oder eine aktuelle Podman-Installation;
- ein freier lokaler Port, standardmäßig
8080; und - ein moderner Browser.
Für einen direkten Quellcode-Build benötigen Sie Node.js 24 und npm. Es ist kein Supabase-Projekt, Cloud-Konto oder separate Datenbank erforderlich.
Installation mit Docker Compose
- Holen Sie sich das Repository und öffnen Sie den Projektordner:
git clone https://github.com/Xoliul/condui-community.git
cd condui-community
- Laden Sie das veröffentlichte Image und starten Sie den Container:
docker compose up -d
- Öffnen Sie http://localhost:8080. Sobald der Container fertig ist, wird die Startseite der Condui-Community angezeigt.
- Überprüfen Sie ggf. den Status oder die Protokolle:
docker compose ps
docker compose logs -f
Stoppen Sie die Anwendung mit:
docker compose down
Installation mit Podman
Erstellen Sie zuerst das OCI-Image:
podman build -t condui-community:local .
Starten Sie dann den Container:
podman run --name condui-community --rm -p 8080:8080 condui-community:local
Öffnen Sie http://localhost:8080. Drücken Sie Ctrl+C, um den Container zu stoppen. Mit Podman Compose können Sie auch das mitgelieferte compose.yaml verwenden.
Erstellen und Ausführen aus dem Quellcode
Überprüfen Sie zunächst, ob Node.js 24 ausgeführt wird:
node --version
Installieren Sie die erfassten Abhängigkeiten, erstellen Sie die Produktionsversion und starten Sie den lokalen Server:
npm ci --ignore-scripts
npm run build
npm start
Öffnen Sie dann http://localhost:8080. Der lokale Server bedient sowohl die Webanwendung als auch lokale Konvertierungsendpunkte für unterstützte Plandateien.
Aktualisieren
Laden Sie die neue Compose-Konfiguration und das veröffentlichte Image:
git pull
docker compose up -d
Erstellen Sie vor einem Update Projektarchive Ihrer wichtigen Projekte. Unterstützte Archive werden beim Öffnen migriert; eine eigene Sicherung bleibt dennoch die zuverlässigste Wiederherstellungsmöglichkeit.
Optionale Speicherung auf dem eigenen Server
Ergänzen Sie diese Volume-Zuordnung unter dem Dienst condui in compose.yaml und starten Sie Compose erneut:
volumes:
- ./condui-data:/data
Projekte, Ordner, Ihr Installateurprofil und Einstellungen liegen dann in condui-data. Geräte, die dieselbe Installation öffnen, sehen dieselbe Projektliste. Beim ersten Öffnen können Sie bestehende Browserprojekte auf den Server verschieben. Dies ist eine gemeinsame Installation ohne separate Benutzerkonten; sichern Sie den gesamten Ordner selbst.
Ohne Passwort ist Community nur aus dem eigenen Netzwerk erreichbar, einschließlich privater Netzwerke wie Tailscale. Für externen Zugriff setzen Sie unter demselben Dienst CONDUI_PASSWORD auf ein Passwort mit mindestens acht Zeichen. Verwenden Sie für Internetzugriff HTTPS über einen Reverse Proxy; das Passwort ist dann auch im eigenen Netzwerk erforderlich.
environment:
CONDUI_PASSWORD: "choose-your-own-password"
Projektspeicherung und Backups
Ohne Serverspeicherung liegen Projekte im Browserspeicher und nicht im Container. Wenn Sie den Container ersetzen oder neu erstellen, bleibt der Browserspeicher normalerweise erhalten. Der Browser behandelt jedoch jede Kombination aus Protokoll, Hostname und Port als eigenen Ursprung. Wechseln Sie beispielsweise von localhost:8080 zu einem anderen Hostnamen oder Port, kann deshalb eine leere Projektliste erscheinen.
Laden Sie wichtige Projekte regelmäßig als Condui-Projektarchiv herunter und speichern Sie die Archive an einem Ort, der gesichert wird. Ein PDF ist ein fertiges Dokument; in der Community Edition enthält es kein eingebettetes, bearbeitbares Projekt.
Keine verwalteten Sicherungen oder Supportgarantie
Eine Community-Installation bietet weder verwalteten Cloud-Speicher noch einen Wiederherstellungsdienst oder eine offizielle Supportgarantie. Wer die Installation betreibt, ist selbst für Updates, Erreichbarkeit und Sicherungen verantwortlich.
Häufige Probleme
- Port 8080 wird bereits verwendet: Ändern Sie in
compose.yamlbeispielsweise8080:8080in8081:8080und öffnen Sie dannhttp://localhost:8081. - Der Quellcode-Build lässt sich nicht starten: Überprüfen Sie, ob
node --versionVersion 24 anzeigt. - Die Projektliste erscheint leer: Öffnen Sie die Anwendung mit genau demselben Hostnamen und Port erneut oder importieren Sie ein zuvor heruntergeladenes Projektarchiv.
- Der Container stoppt beim Erstellen: Sehen Sie sich
docker compose logsan und prüfen Sie, ob Docker über genügend Arbeitsspeicher und freien Speicherplatz verfügt. - Der Browser zeigt eine leere Seite an: Öffnen Sie die Entwicklerkonsole des Browsers. Community läuft im Browser; Docker-Protokolle zeigen nur, ob der lokale Webserver gestartet ist.