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.

Die Community Edition speichert Projekte im Browser des Geräts, an dem Sie arbeiten. Heruntergeladene Condui-Projektarchive sind in beide Richtungen mit der gehosteten Version kompatibel.

Quellcode von Condui Community auf GitHub ansehen.

Welche Installationsmethode wählen Sie?

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

1. Holen Sie sich das Repository und öffnen Sie den Projektordner:

git clone https://github.com/Xoliul/condui-community.git
cd condui-community

1. Erstellen und starten Sie den Container:

docker compose up --build -d

1. Öffnen Sie http://localhost:8080. Sobald der Container fertig ist, wird die Startseite der Condui-Community angezeigt.

1. Ü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

Holen Sie sich einen neuen Community-Snapshot und erstellen Sie den Container neu:

git pull
docker compose up --build -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.

Projektspeicherung und Backups

Projekte werden im Browserspeicher und nicht im Container abgelegt. 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.yaml beispielsweise 8080:8080 in 8081:8080 und öffnen Sie dann http://localhost:8081.
• Der Quellcode-Build lässt sich nicht starten: Überprüfen Sie, ob node --version Version 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 logs an 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.