Unofficial Checkmk App now available

Checkmk Dev&Exchange Community Project Announcements
, , ,
1

German version below

Hi everyone,

a quick update on our unofficial Checkmk app: the app is now officially published and freely available for everyone – both on the Google Play Store and on F-Droid.

The app already has more than 200 monthly users, so maybe there are still a few interested people out there. Feedback and feature suggestions are always very welcome at: checkmk-google@pabr.de

An iOS version will only happen if enough people are willing to chip in together for the 100 €/year Apple Developer account. If you’d be interested in helping to fund that, just drop us a message or use this Link https://ko-fi.com/checkmk

Best regards
Martin & Paul

Hallo zusammen,

kurzes Update zu unserem inoffiziellen Checkmk-App-Projekt: Die App ist jetzt offiziell veröffentlicht und für alle frei verfügbar – sowohl im Google Play Store als auch auf F-Droid.

Die App hat inzwischen über 200 monatliche Nutzer, vielleicht ist ja noch der eine oder andere Interessierte dabei. Feedback und Anregungen für neue Features sind jederzeit herzlich willkommen, gerne an: checkmk-google@pabr.de

Eine iOS-Version wird es nur geben, wenn sich genügend Leute finden, die gemeinsam die 100 € pro Jahr für den Apple-Developer-Account spenden. Wer Interesse hätte, sich daran zu beteiligen, meldet sich am besten ebenfalls unter der oben genannten Adresse oder über diesen Link: https://ko-fi.com/checkmk

Viele Grüße
Martin & Paul

9 Likes
2026 June-July Community Bulletin
2

Shoutout for putting it on F-Droid!

2 Likes
3

An upcoming solution for one of the last pain points. Really nice!

Currently login with 2FA isn’t supported. Are there plans to allow this?

4

Tipping was successful thanks to 2 persons. https://apps.apple.com/de/app/checkwatch/id6757307794 enjoy

Tipping war erfolgreich dank 2 Personen. https://apps.apple.com/de/app/checkwatch/id6757307794 Viel Spaß

5

I have the app downloaded to my iOS device, and according to the “System Health” page, it’s connected and has 100% response success, yet I’m not seeing any hosts or services. I’m running 2.5.0p10 Ultimate (free). Any thoughts?

image
image785×1728 119 KB

6

Hello paulter,

we tried installing the mkp on our CheckMK Pro 2.5.0p10. But we get the following errors:

image
image1371×345 47.6 KB

image
image1647×203 19.2 KB

image
image941×307 19.9 KB

Is there an updated Version for 2.5.0?

Thank You for building a Companion App.

7

On Android, when viewing service actions for issues with long output strings, there is no way to perform the action because the service actions window does not scroll.

8

Hi all, thanks a lot for the feedback. Let me answer everything in one go.

@mape2k - 2FA (and SAML)

Short version: 2FA and SAML are login mechanisms of the Checkmk GUI, not of the REST API. The REST API knows exactly three schemes: Bearer (Authorization: Bearer <user> <secret>), webserver Basic/Digest, and an existing session cookie. There is no endpoint where a client could answer a TOTP challenge, run a WebAuthn ceremony, or complete a SAML redirect/assertion flow - so an app cannot “log in with 2FA/SAML” at all. That is not something we can fix on our side.

What we can do, and what is on the roadmap: login with an automation secret instead of username + password. You create a dedicated automation user for the app under Setup > Users, give it a read-only role and the contact groups it should see, and paste user + secret into the app. Your personal account keeps its 2FA/SAML, the app gets its own credential that you can revoke at any time - which is the better setup anyway. Credentials are stored in the device keystore (Android Keystore / iOS Keychain).

@briand - connected, but no hosts and services

I have to ask first: are you sure that screenshot is from our app? We have no “System Health” page at all - no overall status, no response time, no success rate. The only server info screen we have is under Help > Info, and it is a plain table (Apache, Checkmk, Python, Mod WSGI, WSGI, Edition, Demo). Our iOS app is called “CheckWatch”. So it looks like you’re using a different Checkmk client - in which case I’m afraid I can’t help with that screen.

If you are on ours: the usual cause of “connection fine, lists empty” is permissions, not the app. Login talks to a Setup endpoint, while the host and service lists come from the monitoring endpoints - a user who is in no contact group of any host gets a valid but empty answer there. Quick check in the browser, logged in as the same user:

https://<server>/<site>/check_mk/api/1.0/domain-types/host/collections/all?columns=name&columns=state

If that returns "value": [], it is server side: add the user to the contact groups of the hosts, or give its role the “See all host and services” permission (Setup > Users > Roles & permissions). If the browser shows hosts but the app doesn’t, mail me at checkmk-google@pabr.de with the app version and whether it’s a distributed setup (then please connect to the central site).

@mschaeffler - the MKP

Same suspicion here: we have no MKP, and none is needed. Our app is a pure REST API client - nothing whatsoever is installed on the Checkmk server, and 2.5.0p10 works out of the box. Setup is only: install the app, enter protocol, server, site name, user, password. The package you installed did not come from us, so please just remove it and the errors will go with it. If you can tell me where you downloaded that MKP, I’ll happily point you to the right project - it may well belong to a different Checkmk app.

@wepiha - service actions not scrollable

Confirmed, that is a real bug: the service detail page has a fixed layout, so a long plugin output pushes the action buttons off the screen and nothing scrolls. Fix for the next release: the whole page becomes scrollable or line breaks and long outputs get truncated with an expand option. Thanks for the precise report.

Best regards
Martin & Paul

2 Likes
9

Hello Paulter,

thank you for your help i got it working with out a mkp now.

i got the mkp from that site which also links to your app: CheckWatch - Critical CheckMK Notifications

10

It may not be after all. I don’t have it installed on any Android devices, just my iOS 26 phone. Looking at the App Store listing more closely, its Jaap-Jan G as the developer.

Based on what I see on Ko-fi, it looks like the required funds should have been reached, but there’s no specific application name or link to follow to your app. Maybe consider adding a link or other details to your Ko-fi page to help identify the right app? After some further digging, I think I found your app: Paul a Brassard listed as developer.

That app seems to be working. It’s showing me hosts up, down, services ok and warn that match my UI.

Thanks for the nudge to help me find the right one!

1 Like
11

For reference, this is the app I installed which turned out to be wrong.

This is the one I installed and works for me:

1 Like