Skip to main content

iOS

Prerequisites​

Before setting up the passbolt mobile app on iOS, ensure you have:

  • A passbolt account already configured in your browser
  • Your passbolt server URL
warning

passbolt mobile apps require HTTPS to function. If you're using a self-signed certificate, you'll need to import it to your device first. See our TLS (SSL) certificate import guide for detailed instructions.

Download and Install​

Scan the QR code below to download the passbolt app from the iOS App Store, or search for "passbolt" in the App Store on your device.

QR code to download passbolt from the iOS App Store
fig. Scan to download passbolt from the iOS App Store

Initial Setup​

Step 1: Launch the App​

Open the passbolt app and tap "Connect to an existing account".

Welcome screen of the passbolt mobile app
fig. Welcome screen

Step 2: Choose Setup Option​

Select "Connect to an existing account".

Login options screen in the passbolt mobile app
fig. Choose setup option
warning

It is currently not possible to create an account using the mobile app. You must first create an account using your desktop browser extension.

Step 3: Connect to Existing Account​

  1. Sign in using the browser extension on your desktop
  2. Go to the profile page in your browser
  3. Go to the mobile section in your profile
Mobile setup page in the browser showing QR codes
fig. Mobile setup page in browser

Step 4: Scan QR Code​

  1. In the passbolt mobile app, tap "Scan QR code"
  2. Point your camera at the QR code displayed in your browser
Camera screen for scanning QR code in the passbolt mobile app
fig. Scan QR code

Step 5: Enter Passphrase​

Enter your passphrase to authenticate and complete the setup.

Enter passphrase screen in the passbolt mobile app
fig. Enter passphrase

Step 6: Enable Face ID​

Enable Face ID (recommended) so you can unlock the app with your face.

Enable Face ID in the passbolt iOS app
fig. Enable Face ID

Step 7: Configure Autofill​

Configure autofill settings. See our guide on disabling built-in password managers.

Autofill configuration in the passbolt iOS app
fig. Configure autofill

After enabling autofill, you should see a confirmation screen:

Passbolt autofill enabled confirmation
fig. Passbolt autofill enabled

Disable Built-in Password Manager​

Disable iOS's built-in password manager to prevent conflicts. See our guide on disabling built-in password managers.

Troubleshooting​

Certificate Issues​

Autofill Not Working​

If autofill is not working, check that:

  • The passbolt autofill service is enabled in your device settings
  • You have granted necessary permissions to the passbolt app
  • Your device's built-in password manager is disabled

Next Steps​