Ir al contenido
  •  +49 (861) 88 00 32 00
COD powered by extocode GmbH
  • 0
  • Iniciar sesión
  • English (US) Français Deutsch Español Türkçe
  • Abrir la demo
  • Inicio
  • Resumen COD
    Plataforma
    ResumenPlataforma: clientes y marcaFuncionesProblemas y solucionesArquitecturaDocumentationIntegracionesPrecios
    Operación y Red
    MonitoringRedNetwork Access Control (NAC)TACACS+Captive PortalFirewall
    Seguridad y Resiliencia
    Governance, Risk & ComplianceBackupHypervisorOTPPasskeeprAutomatización
    Soluciones y Más
    NIS2 & CompliancecodPassDocumentación con IA (módulo InfraScan)Abrir la demoReferenciasDescargasFAQ
  • Precios
  • Novedades
    • Blog
    • Hoja de ruta
  • FAQ
  • Sobre nosotros
    • Sobre nosotros
    • Empleo
    • Socios
    • Referencias
  • Academy
  • Contacto
COD powered by extocode GmbH
  • 0
    • Inicio
    • Resumen COD
    • Precios
    • Novedades
      • Blog
      • Hoja de ruta
    • FAQ
    • Sobre nosotros
      • Sobre nosotros
      • Empleo
      • Socios
      • Referencias
    • Academy
    • Contacto
  •  +49 (861) 88 00 32 00
  • English (US) Français Deutsch Español Türkçe
  • Iniciar sesión
  • Abrir la demo
  1. Home
  2. Documentation
  3. Installation

Installation

This page describes how to install COD with Self Hosted, from the server to the final check. With Shared Hosted and Private Hosted, extocode sets up the instance.

As of: November 2026, COD 3.8.6

Documentation contents
  • Overview
  • Getting started
  • Requirements
  • Names and addresses
  • Network devices
  • Time and DNS
  • Installation
  • Deployment shapes
  • Initial setup
  • Updates
  • Modules
  • Troubleshooting
  • Security
  • Versions
  • Version history
  • Support

Documentation

  • Overview
  • Getting started
  • Requirements
  • Names and addresses
  • Network devices
  • Time and DNS
  • Installation
  • Deployment shapes
  • Initial setup
  • Updates
  • Modules
  • Troubleshooting
  • Security
  • Versions
  • Version history
  • Support

Requirements

ItemRequirement
Operating systemUbuntu Server 22.04 LTS, 24.04 LTS or 26.04 LTS, freshly installed
Architectureamd64
Privilegesroot or sudo
Package repositoryCredentials for apt.extoco.de. You receive the repository credentials as part of the project.
Internet during installationextocode's package repository, the Ubuntu archives, the Node.js repository (NodeSource), and on 22.04 and 24.04 also the PostgreSQL repository. Directly or through an HTTP proxy
DatabasesMariaDB and PostgreSQL 18 or later, on the COD server or on your own database servers
TimeNTP on all servers
HardwareYour partner gives you guide values for your size.

COD ships as Debian packages and runs as systemd services. There are no containers. All details are under Requirements. How to spread COD across one or more hosts is described under Deployment shapes.

Procedure at a glance

  1. Provide the servers
  2. Run the setup script on every host
  3. Complete the setup wizard in the browser
  4. Set up HTTPS
  5. Enable modules for the tenant
  6. Roll out modules
  7. Set up TACACS+ and Hypervisor manually
  8. Check the installation

Step 1: Provide the servers

  1. Install Ubuntu Server freshly, in one of the supported versions.
  2. Set up NTP. This applies to the COD server, to database servers and to module servers.
  3. Decide on the name under which users and modules reach COD. A fixed DNS entry and a fixed address are recommended. The name matters for the certificate and for sign-in.
  4. For split deployment shapes, provide all hosts at the same time.

Note: If the address under which COD is reachable changes later, Ansible rollouts fail until you roll out again. See Troubleshooting.

Step 2: Setup script on every host

The setup script adds extocode's package repository with its signing key and installs Node.js 24. It then installs the selected packages and creates the databases and database users. It runs for a few minutes.

You receive the setup script command together with the repository credentials. For the shape "Everything on one server", the script installs the complete package cod-all and the database servers on the same host. Module servers and your own database servers need further settings. Customers and partners receive these as part of the project as well.

Hosts without internet access

SituationApproach
Internet only through a proxyThe setup script fetches the packages through an HTTP proxy
No internetOffline bundle as a local package source, on request. Ask your partner. Technical questions to extocode go through the helpdesk form.

Step 3: Setup wizard in the browser

The wizard runs on the COD server. You open it in the browser with a one-time token. It takes care of these steps:

  1. It checks the connections to the databases, the key service and the cache.
  2. It generates the keys of the installation.
  3. It creates the first superadmin.
  4. It asks for the e-mail address of the manager account.
  5. If you wish, it sets up HTTPS with a certificate authority of the installation.
  6. It shows the QR code for two-factor sign-in (TOTP) of the manager account and a key.

Important: The QR code and the key appear exactly once. Store both right away. The e-mail address of the manager account cannot be changed later.

Important: Back up the configuration with the keys of the installation right after the wizard. Without these keys COD does not start, and encrypted credentials are lost. See Backing up COD itself.

What follows after the wizard is described under Initial setup.

Step 4: Set up HTTPS

HTTPS is mandatory. Without HTTPS, sign-in only works locally on the COD server.

ApproachWhere you set it up
Certificate authority of the installationin the setup wizard
Your own certificatein COD under "Backend config", card "TLS"
Reverse proxy in front of CODon the proxy, plus "trust proxy" in COD. The proxy must pass WebSocket and server-sent events

Details are under Initial setup: HTTPS.

Step 5: Enable modules for the tenant

  1. Sign in with the manager account. Only this account enables modules.
  2. Open "Admin Area > Tenant > Modules".
  3. Select the licensed modules and save.
  4. Sign out and sign in again. Only then does COD show the modules.

Step 6: Roll out modules

The rollout wizard sets up the Ansible, Backup, NAC and Passkeepr modules per location. You find it under "Admin Area > Module Rollout".

  1. "Module": select the module.
  2. "Location": select the location.
  3. "Install": install the module on the target host.
  4. "Connect": connect COD to the module, using the setup address and a handshake token.
  5. "Configure": set the module's settings.
  6. "Apply": apply the settings.

Note: The connection between COD and module servers belongs in a trusted network.

Customers and partners receive the list of connections and firewall rules as part of the project.

Step 7: TACACS+ and Hypervisor manually

The rollout wizard does not cover these two modules.

ModuleWhat you do
TACACS+Set up the service on its host. Then enter the address of the management interface under "Location > Module URLs". The address ends in /api/v1
HypervisorSet up the service on the COD server. It always runs there

The field for the TACACS+ address only appears if NAC, Backup or Passkeepr is also enabled for the tenant. Customers and partners receive the address of the management interface with the list of connections and firewall rules as part of the project.

See TACACS+ and Hypervisor.

Step 8: Check the installation

Run these commands on the COD server:

systemctl --failed
systemctl list-units 'cod-*'
curl -sk https://localhost/api/health
CommandExpected result
systemctl --failedno failed services
systemctl list-units 'cod-*'all installed COD services are running
curl -sk https://localhost/api/health{"status":"ok"}

You can also add the health check to your own monitoring. If a result differs, see Diagnosis.

Handout

The procedure is also available as the handout “Installing and setting up COD”. You find the handout as a PDF on the Downloads page.

Further reading

  • Requirements
  • Deployment shapes
  • Initial setup
  • Updates
  • Troubleshooting
  • COD architecture
  • FAQ: installation and updates
← Previous: Time and DNSNext: Deployment shapes →
Folgen Sie uns
​
  • Resumen COD
  • Funciones
  • Demo
  • Precios
  • Integraciones
  • NIS2
  • codPass
  • Referencias

Help

  • FAQ
  • Documentation
  • Descargas
  • Contacto

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

Utilizamos cookies para proporcionarle una mejor experiencia de usuario en este sitio web. Política de privacidad

Rechazar Aceptar