An Android client for Nagios Core that shows host and service status and can acknowledge problems, built with Jetpack Compose and Material 3.
"Nagios" is a third-party trademark and is intentionally not used in the app name, package id, or display strings.
- Status at a glance — bottom-nav tabs for Hosts / Services / Problems with a summary header showing live state counts.
- Color coding — green for OK/UP, red for CRITICAL/DOWN, amber for WARNING/UNREACHABLE, purple for UNKNOWN; badges for acknowledged and scheduled-downtime objects.
- Filters — tap a summary box to filter by state; search the lists.
- Details — host detail lists its services; service detail shows output, long output, performance data, check timing and state history.
- Acknowledge — acknowledge hosts and services (with a comment) through the external command interface.
- Refresh — pull-to-refresh plus an optional auto-refresh interval.
- Offline cache — last-known status is cached in Room and shown when the server is unreachable, with a "last updated" banner.
- Home-screen widget — host/service/problem totals, refreshed periodically.
- Android 12 (API 31) or newer
- A reachable Nagios Core server exposing the CGI JSON interface
(statusjson.cgi) and, for acknowledgement, the command CGI (cmd.cgi)
Requires JDK 17+ (JDK 21 recommended) and the Android SDK (compile/target
SDK 35). Create local.properties with your SDK path, e.g.:
sdk.dir=/path/to/Android/sdkThen:
./gradlew :app:assembleDebug # build the debug APK
./gradlew :app:testDebugUnitTest # run unit testsThe APK is written to app/build/outputs/apk/debug/app-debug.apk.
Open the Settings tab and set:
- Monitoring web root URL — e.g. http://your-nagios-host/nagios
- Username / Password — HTTP Basic credentials
- Trust self-signed certificates — for HTTPS servers with self-signed certs
- Auto-refresh interval — optional periodic refresh
Credentials are stored in EncryptedSharedPreferences. Use Test connection
to verify the URL and credentials.
- Always sends formatoptions=enumerate; the numericstatusfield is unreliable in Nagios Core 4.5.x. Enumerated values return textual states ("up","ok","hard", ...).
- Queries used: hostcount,servicecount,hostlist,servicelist,host,service,programstatus.
- Acknowledgement uses cmd.cgi(GET to obtain the CSRF form id, then a form POST), since the command interface is not part ofstatusjson.cgi.
- Kotlin + Jetpack Compose + Material 3, Navigation Compose
- Hilt (dependency injection)
- OkHttp + Retrofit + kotlinx.serialization
- Room (offline cache)
- Jetpack Security EncryptedSharedPreferences
- Glance + WorkManager (home-screen widget)
- MVVM + StateFlow + coroutines/Flow
Tagged releases (v*) are built and published automatically by GitHub Actions
(.github/workflows/release.yml). The workflow produces an installable release
APK and attaches it to the GitHub Release and to the workflow run as an artifact.
It can also be run manually from the Actions tab.
To sign releases with your own key, add these repository secrets:
- KEYSTORE_BASE64— your keystore, base64-encoded (- base64 -w0 keystore.jks)
- KEYSTORE_PASSWORD
- KEY_ALIAS
- KEY_PASSWORD
If KEYSTORE_BASE64 is not set, the release APK is signed with the debug key so
it stays installable for testing.
Pull requests and pushes to main run the CI workflow
(.github/workflows/ci.yml): unit tests, lint and a debug build.
Released under the MIT License.