Skip to content

openITCOCKPIT-Desktop

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.

dashboard

dashboard

Installation

  • 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.

Usage

Login

login

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.

Autologin

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.

Profile

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.

Settings

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

Widget

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

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

Customization

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:

Windows

c:\Benutzer\<user>\AppData\Roaming\openITCOCKIT-Desktop
OSX
/users/<user>/Library/Application Support/openITCOCKIT-Desktop
Linux
/home/<user>/.config/openITCOCKIT-Desktop

customAssets

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.

Hostslist

hostslist

Hostbrowser

hostbrowser

Serviceslist

serviceslist

Servicebrowser

servicebrowser