# Install and configure the Cerby mobile app on iOS

The Cerby mobile app enables you to access and manage your accounts, secrets, and collections from your iPhone. 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 iOS:

* Cerby requires iOS 16 as the minimum supported OS version due to security updates and performance improvements. If your iPhone has an older operating system (OS) version, 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.261**, the Cerby mobile app also supports installation on iPads (minimum supported OS: iOS 16)
* Access to a Cerby workspace

***

## Install and configure the Cerby mobile app on iOS

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

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

The following sections describe each main step.

### 1. Install from the App Store

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

1. Open the Cerby mobile app in the [App Store](https://apps.apple.com/us/app/cerby/id1533747684).
2. Tap the **Install** (<img src="/files/7K8C8BbofcksowrFpV2M" alt="" data-size="line">) button. The app is downloaded and installed on your iPhone.

The next step is [2. Turn on the Autofill Service on your iPhone](#id-2.-turn-on-the-autofill-service-on-your-iphone).

### 2. Turn on the Autofill Service on your iPhone

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. Open the Cerby mobile app on your phone. The **Access your items** screen displayed.
2. Swipe the screen to the left until you see the **Easily AutoFill passwords with Cerby** screen.
3. Activate the **Allow AutoFill from Cerby** switch in the **Easily AutoFill passwords with Cerby** screen. The **Turning on Cerby’s AutoFill** screen is displayed with the instructions you must follow on your device.
4. Tap the **Open iPhone setting** button. The **Autofill & Passwords** screen of your iPhone is displayed.
5. Activate the **AutoFill Passwords and Passkeys** switch if it wasn’t previously activated.
6. Activate the **Cerby** switch in the **AutoFill FROM** section. The **Cerby** screen is displayed.
7. Activate the **Auto-Copy One-Time Passwords** switch if it wasn’t previously activated.
8. Tap the **Done** option at the top right corner to return to the previous screen.
9. Return to the Cerby app to continue the app setup.

The next step is [3. Turn on the Allow Notifications feature on your iPhone](#id-3.-turn-on-the-allow-notifications-feature-on-your-iphone).

### 3. Turn on the Allow Notifications feature on your iPhone

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 other actions.

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

1. Swipe the screen to the left. The **Enable notifications to verify your identity** screen is displayed.
2. Activate the **Allow notifications** switch. The **Allow Cerby to send notifications?** dialog box is displayed.
3. Tap the **Allow** option. The **Allow notifications** switch is turned on.
4. Tap the **Continue** button. The **Welcome to Cerby** screen is displayed.

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

### 4. 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. 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. The **Turn on Face ID to unlock Cerby** screen is displayed.

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

### 5. Turn on the Biometrics Login on your iPhone

The Cerby mobile app enables you to use your biometric information, such as your face ID 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](/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:

{% hint style="info" %}
**NOTE:** This step is not mandatory. You can set up the **Biometrics Login** later by tapping the **Maybe later** option in the **Turn on Face ID to unlock Cerby** screen and skipping to step [6. Set up the Cerby mobile app as a trusted session](#id-6.-set-up-the-cerby-mobile-app-as-a-trusted-device).
{% endhint %}

***

1. Tap the **Set up Face ID** button. The iPhone’s Face ID is activated.
2. Look at the phone’s camera. A checkmark indicates that the verification has been completed. The **“Cerby” Would Like to Send You Notifications** message box is displayed.
3. Tap the **Allow** button. The **Set up trusted device** screen is displayed.

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

### 6. 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. Tap the **Set up device** button in the **Let’s set up your mobile device as a trusted device** screen. The **Name your device** screen is displayed.
2. 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.
3. Tap the **Continue** button. The **Verify your identity** screen is displayed with the following options to approve the device from a trusted session:
   * **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.
   * **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.
   * **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.

Now you are done. You can start using Cerby on your iPhone.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.
