Skip to content


The openITCOCKPIT desktop app is a standalone application that can be installed on any modern operating system and provides an overview of current monitoring events and status updates. openITCOCKPIT desktop uses the openITCOCKPIT HTTP API to communicate with the openITCOCKPIT server.




  • Appropriate installation packages are available for every operating system - Linux, Windows, MacOS.
  • The app can be set to automatically search for updates when it starts - or manually via the settings page.




In the first field your server URL enter the URL or IP address of your openITCOCKPIT system. In the second field, enter the API key of a user of the openITCOCKPIT system.

Creation of API Keys

In order to be able to log in, you must first obtain an API key created in your openITCOCKPIT system (siehe API Key erstellen). You can simply enter the key in the Your Api-Key field.


If auto login is set (default), the login data will be saved automatically after a successful login and the login takes place automatically the next time the application is started.


You can create different profiles via the dropdown on the login page. All settings you make in the app are saved in the currently active profile.

After successfully log in, you will be redirected to the dashboard.


All settings on the settings page are saved automatically! settings

  • Enable auto start The application is started when the operating system is started (beta)

  • Close to tray When closing the application via the application bar, the application is not terminated but only hidden, can be displayed again via the tray icon menu.

  • Show widget on start The widget is displayed when the application starts.

  • Show only widget on start When starting the application, only the widget is displayed. widget The main application can be displayed via the menu in the tray.

  • State refresh interval Interval of data retrieval for widget and dashboard (min. 1 minute).

  • Use slow pagination in lists Switch the pagination type

  • Activate widget position storage Automatic save of the position of the widget

  • Activate window posisiton storage Automatic save of the application position and size

  • Disable automatic update checks Turns off the update check when starting the app.

  • Enable push notifications Turns push notifications on/off.

  • Enable dark mode ON/OFF switch Dark Mode explicitly on/off. Auto switches the mode based on the operating system setting.

  • Auto login enabled The application automatically logs in with the last active login data (profile) when it is started.

  • Logout The application logs out and jumps to the login page, for example to change or edit the profile.

  • Check & save Checks and saves the credentials of the active profile

  • Check for update Explicit check whether an update is available for the app.

Widget settings

  • Via the Widget settings tab on the settings page, the filter for the widget can be defined and the order of the widget display can be determined using drag & drop. tray


The second line of the widget shows the unhandled shares. The widget can be positioned using the icon. Clicking on a widget entry brings up the corresponding list in the application. widget


tray Some settings can also be made via the tray icon (right-click).


The openITCOCKPIT desktop application is able to adapt to the identity of the respective company. For this case the app icon (application bar, tray, widget), the logo of the login page and the background image of the login page can be changed. assets

To do this, a folder named customAssets must be created (linked) within the configuration directory of the application.

Depending on the operating system, the configuration directory is in the following locations:


/users/<user>/Library/Application Support/openITCOCKIT-Desktop


Within the customAssets folder, the following file naming conventions must be observed:

Icon: favicon.png Only png as Endung allowed. Depending on the operating system, the dimensions should be slightly different: Windows: min. 64x64, better 256x256 Linux: same as Windows OSX: max. 32x32, better 16x16 - otherwise the icon at the top of the bar will be too big.

logo: logo.png (.svg,.jpg) Any resolution, since it is scaled

background: background.png (.svg, .jpg) Resolution in principle also arbitrary, since it is scaled, but it should be at least FullHD.

Hosts, Services

The host and services views and their detail pages are derived from the corresponding pages of the oitc server's web interface and are therefore not explained in more detail here.









Custom Widgets

With version 4.6.9 of the openITCOCKPIT-Desktop App it is possible to configure and show any number of widgets.




The configuration is extended by the marked Fields. To process this new filter fields the openITCOCKPIT-Backend 4.7.0 is needed.



Known Issues


When you share your screen using Microsoft Teams it can happen that the Widgets of openITCOCKPIT Desktop go into the background. You can resolve the issue by restarting the openITCOCKPIT Desktop application.