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.
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.
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.
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.
- 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.
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.
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:
Within the customAssets folder, the following file naming conventions must be observed:
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.
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.