Lagoon Mobile
A mobile client for the Lagoon application delivery platform. Browse projects and environments, watch deployments and tasks with their build logs, trigger deploys, retrieve backups, and manage variables — across multiple Lagoon instances.
Multi-Instance Contexts
Everything is scoped to a context (one Lagoon instance). Switch between instances with a quick context switcher, mirroring lagoon-cli's context model.
Keycloak OIDC + PKCE
Authorization Code + PKCE through the system browser against each instance's Keycloak realm, with refresh tokens held in secure storage. A pasted static-token fallback covers instances that pin redirect URIs.
Live Deployments & Tasks
Watch deployments and tasks with their build logs. Subscriptions enhance the experience where available; polling keeps everything working when an ingress blocks WebSockets.
Version-Gated GraphQL
Query selections stay conservative so older Lagoon instances keep working. Newer API surface is gated by a semver check against the instance's reported version, and fails closed on anything unknown.
What it does
Lagoon Mobile is a monitor-and-operate client for Lagoon: browse projects and environments, watch deployments and tasks with their build logs, trigger deployEnvironmentLatest, cancelDeployment, invokeRegisteredTask, and raw addTask, browse backups and trigger a retrieval, and manage project- and environment-scoped variables — all scoped to whichever Lagoon instance you’re currently connected to. Android-first, with iOS builds from the same codebase.
Quick start
1. Get a build. Download the latest release APK from GitHub Releases, transfer it to an Android phone, and install it (Android will ask you to allow installs from that source).
2. Add your Lagoon instance. On first launch the app goes straight to Add context. Give it a name and the instance’s GraphQL endpoint (a bare host works too — /graphql is appended). Keycloak and UI URLs are derived automatically and are editable if the instance differs.
3. Sign in. OIDC login opens the system browser against the instance’s Keycloak lagoon realm. See Connecting to a Lagoon Instance if login fails with an Invalid parameter: redirect_uri error.
See Verification Status for what has been confirmed against a real Lagoon instance so far.