Merge pull request #90 from openITCOCKPIT/ITC-3731

ITC-3731 First part of the documentation for the Mobile App

Author: ibering

de/docs/additional/mobile-app.md

@@ -0,0 +1,72 @@
+# Mobile App <span class="badge badge-primary badge-outlined" title="Community Edition">CE</span>
+
+!!! info "Geschlossene Beta"
+    Die openITCOCKPIT Mobile App für iOS und Android befindet sich derzeit in einer geschlossenen Beta-Phase.
+    Zum Zeitpunkt des Lesens ist die App möglicherweise noch nicht im App Store oder im Google Play Store verfügbar.
+
+![openITCOCKPIT iOS App auf einem iPhone 16e](/images/mobile-app/openitcockpit-ios-app.png){ align=center }
+*Grafik: openITCOCKPIT iOS App auf einem iPhone 16e*
+
+
+## Voraussetzungen
+
+- openITCOCKPIT 5.6.1 oder höher
+- iOS 17.5 oder höher
+- Der openITCOCKPIT-Server muss vom mobilen Endgerät aus erreichbar sein (z. B. über VPN oder eine öffentliche IP-Adresse)
+- Ein gültiges HTTPS-Zertifikat ist erforderlich. Selbstsignierte Zertifikate funktionieren in der Regel nicht.
+
+
+## App herunterladen
+
+- Apple App Store
+- Google Play Store
+
+(Links werden hinzugefügt, sobald die App in den Stores verfügbar ist)
+
+## Push-Benachrichtigungen einrichten
+
+Ein großer Vorteil der Mobile App im Vergleich zur webbasierten Variante ist die Möglichkeit, Push-Benachrichtigungen für Alarme zu erhalten.
+Um dies zu aktivieren, müssen Sie Ihren openITCOCKPIT-Server so konfigurieren, dass Benachrichtigungen über den **von der AVENDIS GmbH bereitgestellten Push Gateway Service** gesendet werden.
+Dieser Service ist für openITCOCKPIT-Nutzer kostenlos.
+
+1. Navigieren Sie zu `System configuration -> System -> Push Notification Settings`
+2. Setzen Sie die Relay-Adresse auf `https://pushrelay.openitcockpit.io`
+3. Setzen Sie den Port auf `443`
+4. Klicken Sie auf `Request and test Auth-Key`.
+
+openITCOCKPIT fordert nun einen Authentifizierungsschlüssel beim Push Gateway Service an. Der Push Gateway Service verwendet die übermittelte System-ID,
+um Ihren openITCOCKPIT-Server zu identifizieren, und erzeugt einen neuen Authentifizierungsschlüssel für Ihren Server.
+
+Um die Einrichtung abzuschließen, klicken Sie nach der Schlüsselerstellung auf `Save configuration`.
+
+![Auth-Key anfordern](/images/mobile-app/setup-push-gateway.png)
+
+### Benutzer Kontakten zuweisen
+
+Es ist wichtig, Ihrem openITCOCKPIT-Benutzer einen oder mehrere Kontakte zuzuweisen, um Push-Benachrichtigungen für Alarme zu erhalten.
+
+Navigieren Sie zunächst zu `Monitoring -> Objects -> Contacts` und wählen Sie den Kontakt aus, den Sie Ihrem Benutzer zuweisen möchten, oder erstellen Sie einen neuen Kontakt.
+
+Stellen Sie sicher, dass Ihr openITCOCKPIT-Benutzer im Feld `Users` der Kontaktkonfiguration ausgewählt ist.
+Aktivieren Sie außerdem die Checkbox `Push notifications to browser` für Hosts und Services. Diese Option sendet Benachrichtigungen dann sowohl an die Weboberfläche als auch an die Mobile App.
+
+![Benutzer Kontakten zuweisen](/images/mobile-app/assign-users-to-contacts.png)
+
+Damit die Änderungen wirksam werden, speichern Sie die Kontaktkonfiguration und aktualisieren Sie die Monitoring-Konfiguration.
+
+![Monitoring-Konfiguration aktualisieren](/images/openITCOCKPIT-Refresh-Monitoring-Config.png)
+
+## Mobile App einrichten
+
+Sobald die App auf Ihren mobilen Endgeräten installiert ist, können Sie die App starten und die URL Ihres openITCOCKPIT-Servers eingeben.
+Die App verwendet die openITCOCKPIT-API für die Authentifizierung. Daher müssen Sie zuerst [einen API-Schlüssel erstellen](../../development/api/#api-keys).
+
+![Mobile App Login](/images/mobile-app/iphone-login-docs.png)
+
+Der Einfachheit halber können Sie auch den QR-Code aus der openITCOCKPIT-Weboberfläche scannen, um den API-Schlüssel automatisch zu übernehmen.
+
+## Web Application Firewall (WAF) / Reverse Proxy
+
+Für eine zusätzliche Sicherheitsebene stellen wir eine optionale Web Application Firewall (WAF) / Reverse-Proxy-Konfiguration für die openITCOCKPIT Mobile App bereit. Diese Konfiguration basiert auf Nginx und kann verwendet werden, um Ihren openITCOCKPIT-Server vor bösartigen Anfragen zu schützen.
+
+TBD

de/docs/additional/mobile-website.md

@@ -1,5 +1,13 @@
 # Mobile Webseite  <span class="badge badge-danger badge-outlined" title="Enterprise Edition">EE</span>
 
+
+!!! danger "End of Life"
+    Die Mobile Webseite von openITCOCKPIT wird in dieser Form ab Version 5.6.1 als veraltet markiert.
+    Bitte nutzen Sie die [Mobile App für iOS und Android Geräte](./mobile-app.md).
+    
+    **Das End of Life ist mit der Version 5.7.0 geplant.**
+    Danach wird es eine neue Version der mobilen Webseite geben, welche eine gemeinsame Codebasis mit der Mobilen App nutzt.
+
 ## Installation
 
 Die Mobile Webseite ist so konzipiert, dass Sie auf einem eigenen Server betrieben werden kann.

de/docs/images/mobile-app/Simulator Screenshot - iPhone 17 Pro - 2026-06-24 at 16.46.21.png

@@ -106,7 +106,8 @@ nav:
       - 'Upgrade 4.x zu 5.x': 'additional/upgradev4-v5.md'
       - 'Lets Encrypt Zertifikate für openITCOCKPIT': 'additional/lets-encrypt-openitcockpit.md'
       - 'openITCOCKPIT hinter einem Reverse Proxy betreiben': 'additional/behind-reverse-proxy.md'
-      - 'Mobile Webseite': 'additional/mobile-website.md'
+      - 'Mobile App': 'additional/mobile-app.md'
+      - 'Mobile Webseite (veraltet)': 'additional/mobile-website.md'
       - 'openITCOCKPIT-Desktop': 'additional/oitc-desktop.md'
       - 'Ports': 'additional/ports.md'
       - 'Kiosk Mode': 'additional/kiosk-mode.md'

de/docs/images/mobile-app/Simulator Screenshot - iPhone 17 Pro - 2026-06-24 at 17.20.06.png

@@ -0,0 +1,72 @@
+# Mobile App <span class="badge badge-primary badge-outlined" title="Community Edition">CE</span>
+
+!!! info "Closed Beta"
+    The openITCOCKPIT Mobile App for iOS and Android is currently in closed beta.
+    When reading this, the app maybe is not yet available in the App Store or Google Play Store.
+
+![openITCOCKPIT iOS App running on an iPhone 16e](/images/mobile-app/openitcockpit-ios-app.png){ align=center }
+*Graphic: openITCOCKPIT iOS App running on an iPhone 16e*
+
+
+## Requirements
+
+- openITCOCKPIT 5.6.1 or higher
+- iOS 17.5 or higher
+- The openITCOCKPIT server must be reachable from the mobile device (e.g. via VPN or public IP address)
+- A valid HTTPS certificate is required. Self-signed certificates will most likely not work.
+
+
+## Download the App
+
+- Apple App Store
+- Google Play Store
+
+(Links will be added once the app is available in the stores)
+
+## Setup Push Notifications
+
+A huge benefit of the mobile app, compared to its web-based counterpart is, the ability to receive push notifications for alerts.
+To enable this, you need to configure your openITCOCKPIT server to send notifications though the **Push Gateway Service provided by AVENDIS GmbH**.
+This service is free of charge for openITCOCKPIT users.
+
+1. Navigate to `System configuration -> System -> Push Notification Settings`
+2. Set Relay address to `https://pushrelay.openitcockpit.io`
+3. Set Port to `443`
+4. Click on `Request and test Auth-Key`.
+
+openITCOCKPIT will now request an authentication key from the Push Gateway Service. The Push Gateway Service will use the provided System ID
+to identify your openITCOCKPIT server and will generate a new authentication key for your server.
+
+To complete the setup, make sure to click on `Save configuration` after the key has been generated.
+
+![Request Auth-Key](/images/mobile-app/setup-push-gateway.png)
+
+### Assign Users to Contacts
+
+It is important to assign your openITCOCKPIT user one (or more) contact(s) in order to receive push notifications for alerts.
+
+First, navigate to `Monitoring -> Objects -> Contacts` and select the contact you want to assign to your user, or create a new contact.
+
+Make sure to select your openITCOCKPIT user in the `Users` field of the contact configuration.
+Also tick the checkbox `Push notifications to browser` for hosts and services. This option will now send Notifications to both, the web interface and the mobile app.
+
+![Assign Users to Contacts](/images/mobile-app/assign-users-to-contacts.png)
+
+To apply the changes, make sure to save the contact configuration and refresh the monitoring configuration.
+
+![Refresh monitoring configuration](/images/openITCOCKPIT-Refresh-Monitoring-Config.png)
+
+## Setup the Mobile App
+
+Once the app is installed on your mobile devices, you can start the app and enter the URL of your openITCOCKPIT server.
+The app uses the openITCOCKPIT API for authentication, so you have to [create an API key first](../../development/api/#api-keys).
+
+![Mobile App Login](/images/mobile-app/iphone-login-docs.png)
+
+For convenience, you can also scan the QR code from the openITCOCKPIT web interface to automatically fill in the API key.
+
+## Web Application Firewall (WAF) / Reverse Proxy
+
+For adding an extra layer of security, we provide an optional Web Application Firewall (WAF) / Reverse Proxy configuration for the openITCOCKPIT Mobile App. This configuration is based on Nginx and can be used to protect your openITCOCKPIT server from malicious requests.
+
+TBD