> 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-ios.md).

# Install and configure the Cerby mobile app on iOS

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

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:

* From **v1.0.309**, Cerby requires iOS 18 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 18)
* 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. [Log in to your Cerby workspace](#id-2.-log-in-to-your-cerby-workspace)
3. [Turn on the Autofill Service on your iPhone](#id-3.-turn-on-the-autofill-service-on-your-iphone)
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 iPhone](#id-5.-turn-on-the-biometrics-login-on-your-iphone)
6. [Turn on the Allow Notifications feature on your iPhone](#id-6.-turn-on-the-allow-notifications-feature-on-your-iphone)

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="https://3502182589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe1OvDAanGKqgIi3lWOqj%2Fuploads%2Fgit-blob-d19fe73ea46cc3d208504a82e17753a171ba6d4e%2FAD_4nXflg-14MS3x3cXNQ7kxbMzndIE5fvxAZ-_kRDpWG7gDnu6pqg51PxGkFZ-mTJlDFV3O-UB-FFuESolWbUvMG4vVk5XeyWkRC6v_SiIzU8j-1yE34e3cZoI0PBHNkSWMbX2RLuZIlQ.png?alt=media" alt="" data-size="line">) button. The app is downloaded and installed on your iPhone.
3. Tap **Open** from the App 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. See [Set up the Cerby iOS app](https://help.cerby.com/cerby-mobile-app/installation/set-up-the-cerby-ios-app.md) for the full guided onboarding flow.
{% endhint %}

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

### 3. 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. 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 **Change in Settings** alert is displayed.
2. Tap the **Open Settings** button. The alert closes, and the **Autofill & Passwords** screen of your iPhone is displayed.\
   **NOTE:** The guided setup in the Cerby app advances to the next step as soon as you tap **Open Settings**. You don't need to return to the Cerby app to continue it, finish the following steps in your iPhone Settings at your own pace.
3. Activate the **AutoFill Passwords and Passkeys** switch if it wasn’t previously activated.
4. Activate the **Cerby** switch in the **AutoFill FROM** section. The **Cerby** screen is displayed.
5. Activate the **Auto-Copy One-Time Passwords** switch if it wasn’t previously activated.
6. Tap the **Done** option at the top right corner to return to the previous screen.

{% 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 **Set up trusted device** screen is displayed.\
   **IMPORTANT:** Device setup is a security requirement. You must tap **Setup device** to continue; this screen can't be skipped once you've tapped **Set up now**.
2. Tap the **Setup 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]'s [device model] - iOS`. 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 **Continue** button. The **Verify your identity** screen is displayed with instructions to approve this device from a trusted session:

   1. Open Cerby on a trusted device, such as the Cerby mobile app or the Cerby web app.
   2. Log in to Cerby from that trusted session.
   3. Select the **My profile** option from the user profile menu, located in the top-right corner.
   4. Activate the **My trusted devices** tab in your **Profile** information. The list of your trusted sessions is displayed.
   5. Hover the mouse over the device with the **Pending approval** status. The **Approve** and **Deny** buttons are displayed.
   6. Click the **Approve** button. The **Cerby dashboard** screen and a success message box are displayed on your mobile app.

   While you wait, the **Verify your identity** screen on your iPhone shows a **Waiting for approval...** indicator.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>IMPORTANT:</strong> Keep the <strong>Verify your identity</strong> screen and the Cerby app open. The approval request expires in 5 minutes. If it expires, you must restart the device setup.</p></div>

   If you don't have access to another trusted device, tap the **Send me a verification code** option instead:

   1. 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.
   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.

   Alternatively, tap the **Continue without a secure session** option to skip for now. 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 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](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.
2. Depending on whether your iPhone already has Face ID or Touch ID set up, one of the following occurs:
   * If it's not set up, the **Face ID is not set up** (or **Touch ID is not set up**) alert is displayed. Tap **Set up Face ID** (or **Set up Touch ID**) to open your iPhone's Settings app, or tap **Continue with passcode** to use your device passcode instead of biometrics.
   * If it's already set up, your iPhone's Face ID or Touch ID prompt is displayed. Confirm your identity to turn on Biometrics Login.

{% hint style="info" %}
**NOTE:** 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 iPhone](#id-6.-turn-on-the-allow-notifications-feature-on-your-iphone).

### 6. 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. If notifications aren't already turned on, Cerby displays the **Enable notifications** screen as part of the guided setup. Tap the **Allow notifications** button. The **“Cerby” Would Like to Send You Notifications** dialog box is displayed.
2. Tap the **Allow** option. The **Allow notifications** setting is turned on.

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

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


---

# 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-ios.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.
