Installation: Docker Compose

Installieren Sie KiloCenter mit Docker Compose — starten Sie den MIOTY-Stack mit vier Diensten einschließlich KC-Web, ohne Host-Toolchain.

Ziel

Starten Sie einen funktionsfähigen lokalen Stack mit Docker Compose. Der gesamte Stack — einschließlich KC-Web — läuft vollständig in Containern. Eine Go-Toolchain auf dem Host oder eine Bun-Laufzeitumgebung ist nicht erforderlich.

Schritt 1: Umgebung konfigurieren

Aus kilocenter-modules/:

cp .env.example .env

Bearbeiten .env wenn Sie Datenbankzugangsdaten oder das Protokolllevel ändern möchten. Die Standardwerte funktionieren für eine lokale Evaluierung.

Schritt 2: TLS-Zertifikate generieren

KC-Core benötigt TLS-Zertifikate für BSSCI und SCACI. Generieren Sie sie mit dem certgen im KC-Core-Image integrierten Dienst:

docker compose run --rm certgen

Dateibesitz (Linux): Wenn die erzeugten Dateien root gehören, führen Sie es erneut aus mit UID=$(id -u) GID=$(id -g) vorangestellt.

Dadurch werden vier Dateien erstellt in KC-Core/certificates/:

Datei	Zweck
ca.crt	CA-Zertifikat (an Basisstationen verteilen)
ca.key	CA-Privatschlüssel (sicher aufbewahren, wird zum Signieren von Client-Zertifikaten verwendet)
server.crt	Serverzertifikat (wird von den KC-Core-BSSCI/SCACI-TLS-Listenern verwendet)
server.key	Privater Server-Schlüssel

Für einen Produktions-FQDN geben Sie -server:

docker compose run --rm certgen -dir /app/certificates -days 365 -server bssci.example.com

Wichtig: KC-Core wird ohne diese Zertifikate nicht starten. Auf der Sicherheitsseite finden Sie die vollständige Referenz zu den certgen-Flags, zur Zertifikatsverlängerung und zur Generierung von Client-Zertifikaten.

Schritt 3: Alle Dienste starten

docker compose up --build -d

Dadurch werden alle sieben Laufzeitdienste gebaut und gestartet. Nach einem Rebuild werden bei späteren Starts nach Möglichkeit zwischengespeicherte Layer verwendet.

Schritt 4: Start überprüfen

# Prüfen, ob alle Dienste laufen
docker compose ps

# KC-Core-Status
curl -s http://localhost:8086/health

# KC-Gateway-Status
curl -s http://localhost:8087/health

# nginx-gRPC-Web-Proxy überprüfen (200/401/403 = OK; 502/404 = Proxy defekt)
curl -s -o /dev/null -w "%{http_code}" \
  -X POST \
  -H "Content-Type: application/grpc-web+proto" \
  -H "X-Grpc-Web: 1" \
  --data-binary $'\x00\x00\x00\x00\x00' \
  http://localhost/kilocenter.api.v1.KiloCenterService/GetSystemStatus

Öffnen Sie dann KC-Web in Ihrem Browser:

• http://localhost/

Hinweis: Die MQTT-Integration ist standardmäßig deaktiviert. Der Mosquitto-Broker läuft in Docker, aber KC-Core stellt erst dann eine Verbindung zu ihm her, wenn Sie MQTT in config/config.docker.yaml. Siehe MQTT First Steps, wenn Sie bereit sind, MQTT einzurichten.

Alle Dienste stoppen

docker compose down

Um auch persistente Datenvolumes zu entfernen:

docker compose down -v

---

Quellcode-Entwicklermodus

Für Mitwirkende, die KC-Core, KC-Gateway und KC-Web aus dem Quellcode ausführen möchten:

Schritt 1: Infrastruktur-Container starten

docker compose up -d postgres redis mosquitto

Dadurch werden PostgreSQL (gemappt auf Host-Port 5433), Redis (6379) und Mosquitto (1883) gestartet.

Schritt 2: TLS-Zertifikate generieren

Wie oben — verwenden Sie die certgen Compose-Dienst:

docker compose run --rm certgen

Schritt 3: KC-Web-Abhängigkeiten installieren

Aus kilocenter-modules/KC-Web/:

bun install

Schritt 4: Alle Dienste aus dem Quellcode starten

Aus kilocenter-modules/:

./start-dev.sh

Dadurch werden KC-Core, KC-Gateway und KC-Web gebaut und gestartet. Die Protokolle werden in logs/runtime/. KC-Web ist verfügbar unter http://localhost:5173.

Quellcodedienste stoppen

./stop-all-services.sh

# Infrastruktur-Container stoppen
docker compose stop postgres redis mosquitto