Zum Inhalt springen
  •  +49 (861) 88 00 32 00
COD powered by extocode GmbH
  • 0
  • Anmelden
  • English (US) Français Deutsch Español Türkçe
  • Demo öffnen
  • Home
  • COD Überblick
    Plattform
    ÜberblickPlattform: Mandanten und MarkeFunktionsübersichtProbleme & LösungenArchitekturDokumentationIntegrationenPreise
    Betrieb & Netzwerk
    MonitoringNetzwerkNetwork Access Control (NAC)TACACS+Captive PortalFirewall
    Sicherheit & Resilienz
    Governance, Risk & ComplianceBackupHypervisorOTPPasskeeprAutomatisierung
    Lösungen & Mehr
    NIS2 & CompliancecodPassKI-Dokumentation (Zusatzmodul InfraScan)Demo öffnenReferenzenDownloadsFAQ
  • Preise
  • Neuigkeiten
    • Blog
    • Roadmap
  • FAQ
  • Über uns
    • Über uns
    • Karriere
    • Partner
    • Referenzen
  • Academy
  • Kontakt
COD powered by extocode GmbH
  • 0
    • Home
    • COD Überblick
    • Preise
    • Neuigkeiten
      • Blog
      • Roadmap
    • FAQ
    • Über uns
      • Über uns
      • Karriere
      • Partner
      • Referenzen
    • Academy
    • Kontakt
  •  +49 (861) 88 00 32 00
  • English (US) Français Deutsch Español Türkçe
  • Anmelden
  • Demo öffnen
  1. Start
  2. Dokumentation
  3. Installation

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

Inhalt der Dokumentation
  • Übersicht
  • Erste Schritte
  • Voraussetzungen
  • Namen und Adressen
  • Netzgeräte
  • Zeit und DNS
  • Installation
  • Aufbauformen
  • Ersteinrichtung
  • Updates
  • Module
  • Fehlerbilder
  • Sicherheit
  • Versionen
  • Versionsverlauf
  • Support

Dokumentation

  • Übersicht
  • Erste Schritte
  • Voraussetzungen
  • Namen und Adressen
  • Netzgeräte
  • Zeit und DNS
  • Installation
  • Aufbauformen
  • Ersteinrichtung
  • Updates
  • Module
  • Fehlerbilder
  • Sicherheit
  • Versionen
  • Versionsverlauf
  • Support

Voraussetzungen

PunktAnforderung
BetriebssystemUbuntu Server 22.04 LTS, 24.04 LTS oder 26.04 LTS, frisch installiert
Architekturamd64
Rechteroot oder sudo
PaketquelleZugangsdaten für apt.extoco.de. Die Repository-Zugangsdaten erhalten Sie im Projekt.
Internet beim InstallierenPaketquelle 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
DatenbankenMariaDB und PostgreSQL ab Version 18, auf dem COD-Server oder auf eigenen Datenbankservern
ZeitNTP auf allen Servern
HardwareRichtwerte 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

  1. Server bereitstellen
  2. Einrichtungsskript auf jedem Host ausführen
  3. Einrichtungsassistent im Browser durchlaufen
  4. HTTPS festlegen
  5. Module am Mandanten freischalten
  6. Module ausrollen
  7. TACACS+ und Hypervisor von Hand einrichten
  8. Installation prüfen

Schritt 1: Server bereitstellen

  1. Installieren Sie Ubuntu Server frisch, in einer der unterstützten Versionen.
  2. Richten Sie NTP ein. Das gilt für den COD-Server, für Datenbankserver und für Modul-Server.
  3. 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.
  4. 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

LageWeg
Internet nur über einen ProxyDas Einrichtungsskript bezieht die Pakete über einen HTTP-Proxy
Kein InternetOffline-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:

  1. Er prüft die Verbindungen zu den Datenbanken, zum Schlüsseldienst und zum Cache.
  2. Er erzeugt die Schlüssel der Installation.
  3. Er legt den ersten Superadmin an.
  4. Er fragt die Mailadresse des Manager-Kontos ab.
  5. Auf Wunsch richtet er HTTPS mit einer installationseigenen Zertifizierungsstelle ein.
  6. 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.

WegWo Sie ihn einrichten
Installationseigene Zertifizierungsstelleim Einrichtungsassistenten
Eigenes Zertifikatin COD unter „Backend config“, Karte „TLS“
Reverse Proxy vor CODam 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

  1. Melden Sie sich mit dem Manager-Konto an. Nur dieses Konto schaltet Module frei.
  2. Öffnen Sie „Admin Area > Tenant > Modules“.
  3. Wählen Sie die lizenzierten Module und speichern Sie.
  4. 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“.

  1. „Module“: Modul wählen.
  2. „Location“: Standort wählen.
  3. „Install“: Modul auf dem Ziel-Host installieren.
  4. „Connect“: COD mit dem Modul verbinden, über die Einrichtungsadresse und ein Handshake-Token.
  5. „Configure“: Einstellungen des Moduls setzen.
  6. „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.

ModulWas Sie tun
TACACS+Dienst auf seinem Host einrichten. Danach die Adresse der Verwaltungsschnittstelle unter „Location > Module URLs“ eintragen. Die Adresse endet auf /api/v1
HypervisorDienst 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
BefehlErwartetes Ergebnis
systemctl --failedkeine 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
← Zurück: Zeit und DNSWeiter: Aufbauformen →
Folgen Sie uns
​
  • COD Überblick
  • Funktionen
  • Demo
  • Preise
  • Integrationen
  • NIS2
  • codPass
  • Referenzen

Hilfe

  • FAQ
  • Dokumentation
  • Downloads
  • Kontakt

Kotzinger Straße 21 • 83278 Traunstein • Deutschland

  • ​+49 (861) 88 00 32 00
  • ​info@extocode.com
Datenschutz Impressum ​
Copyright © extocode GmbH
English (US) Français Deutsch Español Türkçe

Wir verwenden Cookies auf dieser Website, um Ihnen ein besseres Nutzererlebnis zu bieten. Datenschutz-Richtlinien

Ablehnen Zustimmen