Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Installation and setup

The Grafana OnCall mobile app is an extension of your Grafana OnCall instance. Grafana OnCall is available for Grafana Cloud and Grafana open source users. You must have a Grafana OnCall account to use this application.

Installation of the Grafana Oncall Mobile app

Mobile app download:

Connect your Grafana OnCall account

The OnCall mobile app uses a QR code authentication to connect to your Grafana OnCall instance. You can associate one Grafana OnCall user with your OnCall mobile app.

To connect your account in the mobile app:

  1. Open the Grafana OnCall mobile app and tap Sign in
  2. Follow the instructions in the app to complete QR code authentication
  3. Once the scan is successful, your mobile app is connected to OnCall

Where can I find my QR code?

To access your QR code:

  1. Open Grafana OnCall from your desktop
  2. Navigate to the Users tab, then tap View my profile
  3. tap Mobile app connection in your profile

Note: The QR code will timeout for security purposes - Screenshots of the QR code are unlikely to work for authentication.

Connect to your open source Grafana OnCall account

Grafana OnCall OSS relies on Grafana Cloud OnCall as on relay for push notifications. You must first connect your Grafana OnCall OSS to Grafana Cloud OnCall for the mobile app to work.

To connect to Grafana Cloud OnCall, refer to the Cloud page in your OSS Grafana OnCall instance.

For Grafana OnCall OSS, the QR code includes an authentication token along with a backend URL. Your Grafana OnCall OSS instance should be reachable from the same network as your mobile device, preferably from the internet.

Connect to multiple OnCall stacks

The OnCall mobile app provides a seamless experience for managing multiple OnCall stacks/accounts.

With just a few taps, you can add and switch between different stacks, ensuring you have access to all your alerts and schedules without the need to log in and out repeatedly. This feature is designed to support professionals managing multiple projects or working across different teams, enhancing efficiency and response times.

Simply navigate to the settings menu, select the account tile, tap on the + icon and scan the QR code of the stack you wish to connect.

To switch stack, just select the one you wish to visualize from the accounts page.

Stay organized and responsive by managing all your OnCall needs in one place.