Skip to content

Installation

openITCOCKPIT is installed via the package manager of your respective Linux distribution.

Supported operating systems

  • Ubuntu
    • Jammy (22.04)
    • Focal (20.04)
  • Debian
    • Bullseye (11)
    • Bookworm (12)
  • Enterprise Linux
    • Red Hat 8
    • Red Hat 9

arm64 / Raspberry Pi

openITCOCKPIT and all components are also available for arm64 processors and the Raspberry Pi.

The installation is the same as for a 64-bit system with an AMD or Intel processor. If you want to use a Raspberry Pi system, the 64-Bit version of the Raspberry Pi OS must be used.

Adding the repository

Ubuntu

add-apt-repository universe
apt-get install apt-transport-https curl gnupg2 ca-certificates

mkdir -p /etc/apt/keyrings
curl https://packages.openitcockpit.io/repokey.txt | tee /etc/apt/keyrings/openitcockpit-keyring.asc
echo "deb [signed-by=/etc/apt/keyrings/openitcockpit-keyring.asc] https://packages.openitcockpit.io/openitcockpit/$(lsb_release -sc)/stable $(lsb_release -sc) main" > /etc/apt/sources.list.d/openitcockpit.list
apt-get update

Debian

Debian 11

Ensure you have enabled contrib and non-free repositories in /etc/apt/sources.list

echo "deb http://deb.debian.org/debian/ $(lsb_release -sc) main contrib non-free" > /etc/apt/sources.list
echo "deb-src http://deb.debian.org/debian/ $(lsb_release -sc) main contrib non-free" >> /etc/apt/sources.list

echo "deb http://deb.debian.org/debian-security/ $(lsb_release -sc)-security main contrib non-free" >> /etc/apt/sources.list
echo "deb-src http://deb.debian.org/debian-security/ $(lsb_release -sc)-security main contrib non-free" >> /etc/apt/sources.list

echo "deb http://deb.debian.org/debian/ $(lsb_release -sc)-updates main contrib non-free" >> /etc/apt/sources.list
echo "deb-src http://deb.debian.org/debian/ $(lsb_release -sc)-updates main contrib non-free" >> /etc/apt/sources.list

Debian 12

Ensure you have enabled contrib and non-free repositories in /etc/apt/sources.list.d/debian.sources 

Types: deb deb-src
URIs: mirror+file:///etc/apt/mirrors/debian.list
Suites: bookworm bookworm-updates bookworm-backports
Components: main contrib non-free non-free-firmware

Types: deb deb-src
URIs: mirror+file:///etc/apt/mirrors/debian-security.list
Suites: bookworm-security
Components: main contrib non-free non-free-firmware

Enable openITCOCKPIT repository 

apt-get install apt-transport-https curl gnupg2 ca-certificates

mkdir -p /etc/apt/keyrings
curl https://packages.openitcockpit.io/repokey.txt | tee /etc/apt/keyrings/openitcockpit-keyring.asc
echo "deb [signed-by=/etc/apt/keyrings/openitcockpit-keyring.asc] https://packages.openitcockpit.io/openitcockpit/$(lsb_release -sc)/stable $(lsb_release -sc) main" > /etc/apt/sources.list.d/openitcockpit.list
apt-get update

Installing openITCOCKPIT

The actual installation is carried out by executing the following command: 

apt-get install openitcockpit

You will now need to perform the basic configuration. During this process, for example, the first user for the web interface will be created. The rest of the configuration is then carried out via the openITCOCKPIT web interface.

/opt/openitc/frontend/SETUP.sh

Registering the openITCOCKPIT Community Edition

This step is optional and voluntary. You can expand your openITCOCKPIT installation's range of functions through the addition of modules. Several are available for free. In order to gain access to the community modules, you must first enter the openITCOCKPIT community key. To do this, click on System -> Registration and insert the following key: e5aef99e-817b-0ff5-3f0e-140c1f342792.

No further information is required.

Valid license

After being successfully activated, the community modules will be available under System Tools -> Package Manager.

Installing phpMyAdmin

This step is optional and voluntary. The openITCOCKPIT system uses a MySQL database. Generally speaking, end users will not directly interact with the database. Experienced users, however, can install the phpMyAdmin tool for managing the database.

apt-get install phpmyadmin

The web server will be configured automatically. The phpMyAdmin interface can then be reached via https://xxx.xxx.xxx.xxx/phpmyadmin.

System requirements

  • Ubuntu Linux 64 bit (22.04, 20.04, 18.04), Debian Linux 64 bit (11, 10)
  • 2 CPU cores (x86-64 or arm64)
  • 2 GB RAM
  • 40 GB of free hard disk space