Installation
Diese Seite beschreibt die Installation von COD bei Self Hosted, vom Server bis zur Prüfung. Bei Shared Hosted und Private Hosted richtet extocode die Instanz ein.
Stand: November 2026, COD 3.8.6
Dokumentation
Voraussetzungen
| Punkt | Anforderung |
|---|---|
| Betriebssystem | Ubuntu Server 22.04 LTS, 24.04 LTS oder 26.04 LTS, frisch installiert |
| Architektur | amd64 |
| Rechte | root oder sudo |
| Paketquelle | Zugangsdaten für apt.extoco.de. Die Repository-Zugangsdaten erhalten Sie im Projekt. |
| Internet beim Installieren | Paketquelle von extocode, Ubuntu-Paketquellen, Paketquelle für Node.js (NodeSource), auf 22.04 und 24.04 auch die Paketquelle von PostgreSQL. Direkt oder über einen HTTP-Proxy |
| Datenbanken | MariaDB und PostgreSQL ab Version 18, auf dem COD-Server oder auf eigenen Datenbankservern |
| Zeit | NTP auf allen Servern |
| Hardware | Richtwerte für Ihre Größe nennt Ihr Partner. |
COD kommt als Debian-Pakete und läuft als systemd-Dienste. Container gibt es nicht. Alle Einzelheiten stehen unter Voraussetzungen. Wie Sie COD auf einen oder mehrere Hosts verteilen, steht unter Aufbauformen.
Ablauf im Überblick
- Server bereitstellen
- Einrichtungsskript auf jedem Host ausführen
- Einrichtungsassistent im Browser durchlaufen
- HTTPS festlegen
- Module am Mandanten freischalten
- Module ausrollen
- TACACS+ und Hypervisor von Hand einrichten
- Installation prüfen
Schritt 1: Server bereitstellen
- Installieren Sie Ubuntu Server frisch, in einer der unterstützten Versionen.
- Richten Sie NTP ein. Das gilt für den COD-Server, für Datenbankserver und für Modul-Server.
- Legen Sie den Namen fest, unter dem Anwender und Module COD erreichen. Empfohlen sind ein fester Eintrag im DNS und eine feste Adresse. Der Name zählt für das Zertifikat und für die Anmeldung.
- Stellen Sie bei getrennten Aufbauformen alle Hosts gleichzeitig bereit.
Hinweis: Ändert sich später die Adresse, unter der COD erreichbar ist, brechen Ansible-Rollouts ab, bis Sie neu ausrollen. Mehr dazu unter Fehlerbilder.
Schritt 2: Einrichtungsskript auf jedem Host
Das Einrichtungsskript trägt die Paketquelle von extocode mit ihrem Signaturschlüssel ein und installiert Node.js 24. Danach installiert es die gewählten Pakete und legt Datenbanken und Datenbankbenutzer an. Es läuft einige Minuten.
Den Aufruf des Einrichtungsskripts erhalten Sie zusammen mit den Repository-Zugangsdaten. Für die Aufbauform „Alles auf einem Server“ installiert das Skript das Gesamtpaket cod-all und die Datenbankserver auf demselben Host. Modul-Server und eigene Datenbankserver brauchen weitere Angaben. Auch diese erhalten Kunden und Partner im Projekt.
Hosts ohne Internet
| Lage | Weg |
|---|---|
| Internet nur über einen Proxy | Das Einrichtungsskript bezieht die Pakete über einen HTTP-Proxy |
| Kein Internet | Offline-Bündel als lokale Paketquelle, auf Anfrage. Fragen Sie Ihren Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular. |
Schritt 3: Einrichtungsassistent im Browser
Der Assistent läuft auf dem COD-Server. Sie öffnen ihn im Browser mit einem Einmal-Token. Er erledigt diese Schritte:
- Er prüft die Verbindungen zu den Datenbanken, zum Schlüsseldienst und zum Cache.
- Er erzeugt die Schlüssel der Installation.
- Er legt den ersten Superadmin an.
- Er fragt die Mailadresse des Manager-Kontos ab.
- Auf Wunsch richtet er HTTPS mit einer installationseigenen Zertifizierungsstelle ein.
- Er zeigt den QR-Code für die Zwei-Faktor-Anmeldung (TOTP) des Manager-Kontos und einen Schlüssel an.
Wichtig: QR-Code und Schlüssel erscheinen genau einmal. Sichern Sie beides sofort. Die Mailadresse des Manager-Kontos lässt sich später nicht ändern.
Wichtig: Sichern Sie die Konfiguration mit den Schlüsseln der Installation gleich nach dem Assistenten. Ohne diese Schlüssel startet COD nicht, und verschlüsselte Zugangsdaten sind verloren. Mehr dazu unter COD selbst sichern.
Was nach dem Assistenten folgt, steht unter Ersteinrichtung.
Schritt 4: HTTPS festlegen
HTTPS ist Pflicht. Ohne HTTPS ist eine Anmeldung nur lokal auf dem COD-Server möglich.
| Weg | Wo Sie ihn einrichten |
|---|---|
| Installationseigene Zertifizierungsstelle | im Einrichtungsassistenten |
| Eigenes Zertifikat | in COD unter „Backend config“, Karte „TLS“ |
| Reverse Proxy vor COD | am Proxy, dazu „trust proxy“ in COD. Der Proxy muss WebSocket und Server-Sent Events durchlassen |
Einzelheiten stehen unter Ersteinrichtung: HTTPS.
Schritt 5: Module am Mandanten freischalten
- Melden Sie sich mit dem Manager-Konto an. Nur dieses Konto schaltet Module frei.
- Öffnen Sie „Admin Area > Tenant > Modules“.
- Wählen Sie die lizenzierten Module und speichern Sie.
- Melden Sie sich ab und wieder an. Erst dann zeigt COD die Module.
Schritt 6: Module ausrollen
Der Rollout-Assistent richtet die Module Ansible, Backup, NAC und Passkeepr je Standort ein. Sie finden ihn unter „Admin Area > Module Rollout“.
- „Module“: Modul wählen.
- „Location“: Standort wählen.
- „Install“: Modul auf dem Ziel-Host installieren.
- „Connect“: COD mit dem Modul verbinden, über die Einrichtungsadresse und ein Handshake-Token.
- „Configure“: Einstellungen des Moduls setzen.
- „Apply“: Einstellungen übernehmen.
Hinweis: Die Verbindung zwischen COD und Modul-Servern gehört in ein vertrauenswürdiges Netz.
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Schritt 7: TACACS+ und Hypervisor von Hand
Diese beiden Module deckt der Rollout-Assistent nicht ab.
| Modul | Was Sie tun |
|---|---|
| TACACS+ | Dienst auf seinem Host einrichten. Danach die Adresse der Verwaltungsschnittstelle unter „Location > Module URLs“ eintragen. Die Adresse endet auf /api/v1 |
| Hypervisor | Dienst auf dem COD-Server einrichten. Er läuft immer dort |
Das Feld für die TACACS+-Adresse erscheint nur, wenn am Mandanten zusätzlich NAC, Backup oder Passkeepr freigeschaltet ist. Die Adresse der Verwaltungsschnittstelle erhalten Kunden und Partner mit der Liste der Verbindungen und Freigaben im Projekt.
Mehr dazu unter TACACS+ und Hypervisor.
Schritt 8: Installation prüfen
Führen Sie auf dem COD-Server diese Befehle aus:
systemctl --failed
systemctl list-units 'cod-*'
curl -sk https://localhost/api/health
| Befehl | Erwartetes Ergebnis |
|---|---|
systemctl --failed | keine fehlgeschlagenen Dienste |
systemctl list-units 'cod-*' | alle installierten COD-Dienste laufen |
curl -sk https://localhost/api/health | {"status":"ok"} |
Die Health-Abfrage können Sie auch in Ihr eigenes Monitoring aufnehmen. Weicht ein Ergebnis ab, hilft der Abschnitt Diagnose.
Handout
Den Ablauf gibt es als Handout „COD installieren und einrichten“. Sie finden das Handout als PDF auf der Seite Downloads.
Weiterführend
- Voraussetzungen
- Aufbauformen
- Ersteinrichtung
- Updates
- Fehlerbilder
- Architektur von COD
- FAQ: Installation und Updates