> For the complete documentation index, see [llms.txt](https://help.cerby.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cerby.com/cerby-mobile-app/installation/install-and-configure-the-cerby-mobile-app-on-android.md).

# Install and configure the Cerby mobile app on Android

This article describes the key steps to install and configure the Cerby mobile app on Android.

The Cerby mobile app enables you to access and manage your accounts, secrets, and collections from your Android mobile phone. It also serves as a secondary device to authenticate sensitive tasks, providing verification codes and confirming your identity through push notifications.

***

## Requirements

The following are the requirements to install, configure, and use the Cerby mobile app on Android:

* **Android 11** is the minimum supported operating system (OS) version due to security updates and performance improvements. If your mobile phone has an older OS, refer to the article [Troubleshooting: Older operating systems are no longer supported by the Cerby mobile app](https://help.cerby.com/tips-and-troubleshooting/troubleshooting/cerby-mobile-app/troubleshooting-older-operating-systems-no-longer-supported-by-the-cerby-mobile-app)
* From **v1.0.216**, the Cerby mobile app also supports tablet installation (minimum supported OS: Android 11)
* Access to a Cerby workspace

***

## Install and configure the Cerby mobile app on Android

To install and configure the Cerby mobile app on your Android mobile phone, you must complete the following main steps:

1. [Install from the Play Store](#id-1.-install-from-the-play-store)
2. [Log in to your Cerby workspace](#id-2.-log-in-to-your-cerby-workspace)
3. [Turn on the Autofill Service on your mobile phone](#id-3.-turn-on-the-autofill-service-on-your-mobile-phone)
4. [Set up the Cerby mobile app as a trusted device](#id-4.-set-up-the-cerby-mobile-app-as-a-trusted-device)
5. [Turn on the Biometrics Login on your mobile phone](#id-5.-turn-on-the-biometrics-login-on-your-mobile-phone)
6. [Turn on the Allow notifications feature on your mobile phone](#id-6.-turn-on-the-allow-notifications-feature-on-your-mobile-phone)

The following sections describe each main step.

### 1. Install from the Play Store

To install the Cerby mobile app on your mobile phone from the Play Store, you must complete the following steps:

1. Open the Cerby mobile app in [Google Play](https://play.google.com/store/apps/details?id=com.cerby\&hl=da\&gl=US).
2. Tap the **Install** button. The Cerby mobile app is downloaded and installed on your phone.
3. Tap **Open** from the Play Store, or open the Cerby mobile app from your home screen.

The next step is [2. Log in to your Cerby workspace](#id-2.-log-in-to-your-cerby-workspace).

### 2. Log in to your Cerby workspace

To log in to your Cerby workspace with the Cerby mobile app, you must complete the following steps:

1. Tap the **Log in** button on the **Welcome to Cerby** screen. The **Let’s find your workspace account** screen is displayed.
2. Enter the name of your Cerby workspace in the **Enter your workspace name below** field.
3. Tap the **Next** button. The login page of your identity provider (IdP) is displayed.
4. Log in to your IdP.

{% hint style="info" %}
**NOTE:** When you log in for the first time on a device, Cerby automatically starts a guided setup that walks you through turning on Autofill, setting up a trusted device, turning on Biometrics Login, and turning on notifications, in that order. Cerby only shows the steps that aren't already configured, and you can tap **Maybe later** on any step to skip it for now.
{% endhint %}

The next step is [3. Turn on the Autofill Service on your mobile phone](#id-3.-turn-on-the-autofill-service-on-your-mobile-phone).

### 3. Turn on the Autofill Service on your mobile phone

The **Autofill Service** feature enables Cerby to securely and efficiently manage and fill in usernames and passwords within apps and login pages, saving you the hassle of manually entering your login credentials every time you log in to your corporate account.

To continue the configuration of the Cerby mobile app and turn on the **Autofill Service**, you must complete the following steps:

1. If Autofill isn't already turned on, Cerby displays the **Turn on Autofill** screen as part of the guided setup. Tap the **Turn on now** button. The **Preferred service** screen is displayed, showing available options to store and manage passwords, access keys, and autofill information in your mobile phone.\
   **NOTE:** The guided setup in the Cerby app advances to the next step as soon as you tap **Turn on now**. You don't need to return to the Cerby app to continue it, finish the following steps at your own pace.
2. Select the **Cerby** option. The **Cerby Service Statement** dialog box is displayed.
3. Tap the **OK** button to agree to the service statement. The dialog box closes.

{% hint style="info" %}
**NOTE:** Tap **Maybe later** on the **Turn on Autofill** screen to skip this step for now. Cerby shows it again the next time you log in on this device, until you turn it on.
{% endhint %}

The next step is [4. Set up the Cerby mobile app as a trusted device](#id-4.-set-up-the-cerby-mobile-app-as-a-trusted-device).

### 4. Set up the Cerby mobile app as a trusted device

Trusted sessions and devices provide users with an additional layer of protection by ensuring that all interactions with Cerby come from authorized devices that meet corporate security standards. To learn more about trusted sessions.

To continue the configuration and set up your Cerby mobile app as a trusted device, you must complete the following steps:

1. If your device isn't trusted yet, Cerby displays the **Set up a trusted device** screen as part of the guided setup. Tap the **Set up now** button. The **Let’s set up your mobile device as a trusted device** screen is displayed.
2. Tap the **Set up device** button. The **Name your device** screen is displayed.
3. Enter a name for your device in the **Device name** field.\
   **NOTE:** Cerby automatically creates a name for you using the format: `[username] - [operating system]`. If you want to change it, Cerby recommends using a device name you can easily recognize and including the name of your mobile OS. Device names must be unique.
4. Tap the **Next** button. The **Verify your identity** screen is displayed with the following options to approve the device from a trusted session:
   * **Waiting for approval…**
     1. Log in to Cerby from a trusted session on the Cerby web app.
     2. Select the **My profile** option from the user profile menu located in the top-right corner.
     3. Activate the **My trusted devices** tab in your **Profile** information. The list of your trusted sessions is displayed.
     4. Hover the mouse over the device with the **Pending approval** status. The **Approve** and **Deny** buttons are displayed.
     5. Click the **Approve** button. The Cerby dashboard screen and a success message box are displayed on your mobile app.
   * **I don’t have access to my trusted device**
     1. Tap the **I don’t have access to my trusted device** option. The **Verify your device** screen is displayed, and a message with a verification code is sent to your email.
     2. Copy the verification code from the email Cerby sent you.\
        **IMPORTANT:** The verification code expires in 5 minutes.
     3. Enter the code in the **Verification code** field in your mobile app.
     4. Tap the **Verify code** button. The dialog box closes, and a success message box is displayed. The Cerby dashboard screen and a success message box are displayed on your mobile app.
   * **Continue without a secure session**
     1. Tap the **Continue** without a secure session option. The Cerby dashboard screen and a warning banner indicating that your session is not secured are displayed. You can set up the trusted session by tapping the **Right** arrow () button and following the instructions.

{% hint style="info" %}
**NOTE:** Tap **Maybe later** on the **Set up a trusted device** screen to skip this step for now.
{% endhint %}

The next step is [5. Turn on the Biometrics Login on your mobile phone](#id-5.-turn-on-the-biometrics-login-on-your-mobile-phone).

### 5. Turn on the Biometrics Login on your mobile phone

The Cerby mobile app enables you to use your biometric information, such as your face or fingerprint, to unlock the app and add an extra layer of security to your app. To learn more about this feature, refer to the article [Turn on the Biometrics Login feature](https://help.cerby.com/cerby-mobile-app/app-customization/turn-on-the-biometrics-login-feature.md).

To continue the configuration and turn on the **Biometrics Login** feature, you must complete the following steps:

1. If Biometrics Login isn't already turned on, Cerby displays the **Turn on biometrics to unlock Cerby** screen as part of the guided setup. Tap the **Turn on now** button. Your phone's biometric prompt (fingerprint or face recognition, depending on your device) is displayed.
2. Confirm your identity to turn on Biometrics Login.

{% hint style="info" %}
**NOTE:** If biometric verification fails, or your phone doesn't have a biometric method configured, a message is displayed after the attempt instead of a confirmation dialog box beforehand. Tap **Maybe later** on the **Turn on biometrics to unlock Cerby** screen to skip this step for now.
{% endhint %}

The next step is [6. Turn on the Allow notifications feature on your mobile phone](#id-6.-turn-on-the-allow-notifications-feature-on-your-mobile-phone).

### 6. Turn on the Allow notifications feature on your mobile phone

The **Allow Notifications** feature enables you to receive real-time alerts and updates from the Cerby mobile app, such as verifying your identity to reveal a secret or performing other actions.

To continue the configuration and turn on the **Allow Notifications** feature, you must complete the following steps:

1. If notifications aren't already turned on, Cerby displays the **Enable notifications** screen as part of the guided setup. Tap the **Allow notifications** button.
2. Depending on your Android version and whether the permission has already been requested, one of the following occurs:
   * The **Allow Cerby to send you notifications?** system dialog box is displayed. Select the **Allow** option.
   * Your phone's notification settings screen for the Cerby app opens directly. Turn on notifications there.

{% hint style="info" %}
**NOTE:** Tap **Maybe later** on the **Enable notifications** screen to skip this step for now.
{% endhint %}

Now you are done.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.cerby.com/cerby-mobile-app/installation/install-and-configure-the-cerby-mobile-app-on-android.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
