> ## Documentation Index
> Fetch the complete documentation index at: https://support.onroamly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install with the Roamly iPhone app

> Open your plan and tap Install on this device. iOS walks you through the rest in about a minute.

The app is the easiest way to install: one tap hands the eSIM to iOS, with nothing to scan or type. Do it at home before you travel, while you're online.

<Info>
  Run through the [four quick checks](/installing/before-you-install) first if this is your first eSIM.
</Info>

<Steps>
  <Step title="Open your plan">
    In the [Roamly app](https://apps.apple.com/app/roamly-esim-for-travellers/id6784954599), open the **My eSIMs** tab and tap your plan. When it's ready to install, it's marked **Ready**.

    <Frame>
      <img src="https://mintcdn.com/roamly-support/tvts_C2A1tz3UsYQ/images/installing/iphone-app/1a-my-esims-tab.webp?fit=max&auto=format&n=tvts_C2A1tz3UsYQ&q=85&s=c8bcbdecb264a36e4f6f3ab093788864" alt="The Roamly app's tab bar with My eSIMs highlighted" width="2400" height="1254" data-path="images/installing/iphone-app/1a-my-esims-tab.webp" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/roamly-support/tvts_C2A1tz3UsYQ/images/installing/iphone-app/1b-open-your-plan.webp?fit=max&auto=format&n=tvts_C2A1tz3UsYQ&q=85&s=3a863a5196c16f5636169bc21975e663" alt="The My eSIMs list with a plan marked Ready" width="2400" height="1254" data-path="images/installing/iphone-app/1b-open-your-plan.webp" />
    </Frame>
  </Step>

  <Step title="Tap Install on this device">
    Under **Your eSIM is ready**, tap **Install on this device**.

    <Frame>
      <img src="https://mintcdn.com/roamly-support/tvts_C2A1tz3UsYQ/images/installing/iphone-app/2-install-on-this-device.webp?fit=max&auto=format&n=tvts_C2A1tz3UsYQ&q=85&s=37343adf37d5170dcec5aaa810f58cc9" alt="The plan page with Install on this device highlighted" width="2400" height="1254" data-path="images/installing/iphone-app/2-install-on-this-device.webp" />
    </Frame>
  </Step>

  <Step title="Tap Activate">
    iOS opens Settings and asks to activate your eSIM. Tap **Activate**. The message about sharing your EID with the service provider is normal: it's how every eSIM is delivered to a phone.

    <Frame>
      <img src="https://mintcdn.com/roamly-support/tvts_C2A1tz3UsYQ/images/installing/iphone-app/3-activate-your-esim.webp?fit=max&auto=format&n=tvts_C2A1tz3UsYQ&q=85&s=5a532ea5c653cac449e4b206d318e689" alt="iOS asking to activate your eSIM, with the Activate button" width="2400" height="1254" data-path="images/installing/iphone-app/3-activate-your-esim.webp" />
    </Frame>
  </Step>

  <Step title="Follow the prompts">
    iOS asks a few questions. The answers that keep your normal number working as before:

    * **Label** — call it something you'll recognise, like *Travel* or the country you're visiting.
    * **Default line** — keep your normal SIM for calls and messages. Roamly is data-only.
    * **Mobile data** — keep your normal SIM for now. You'll switch to Roamly when you land.
  </Step>

  <Step title="Switch the Roamly line off until you land">
    Once iOS confirms the eSIM is installed, open **Settings → Mobile** (older iPhones say *Mobile Service* or *Mobile Data*; some regions say *Cellular*), tap your Roamly line and turn **Turn on this Line** off. The plan won't start until you turn it on and connect at your destination.
  </Step>

  <Step title="Turn off Data Roaming on your normal SIM">
    While you're still at home: in **Settings → Mobile**, tap your normal SIM under SIMs (usually labelled *Primary*) and turn **Data Roaming** off. That's the switch that stops your home carrier charging you overseas. If you won't need calls or texts on your number while you're away, you can turn that line off entirely instead; it comes back exactly as it was when you switch it on at home.

    <Frame>
      <img src="https://mintcdn.com/roamly-support/tvts_C2A1tz3UsYQ/images/installing/iphone-app/6a-tap-your-normal-sim.webp?fit=max&auto=format&n=tvts_C2A1tz3UsYQ&q=85&s=c633f42dd198130eecc52460a0ce9728" alt="Settings → Mobile with the Primary SIM highlighted under SIMs" width="2400" height="1254" data-path="images/installing/iphone-app/6a-tap-your-normal-sim.webp" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/roamly-support/tvts_C2A1tz3UsYQ/images/installing/iphone-app/6b-data-roaming-off.webp?fit=max&auto=format&n=tvts_C2A1tz3UsYQ&q=85&s=49edf42b7ac9e1b0a8de017ef0546929" alt="The Primary SIM's settings with the Data Roaming switch highlighted" width="2400" height="1254" data-path="images/installing/iphone-app/6b-data-roaming-off.webp" />
    </Frame>
  </Step>
</Steps>

<Check>
  Back in the app your plan now shows **Installed on your device**. That's it until you fly.
</Check>

## When you land

Three switches get you online: turn the Roamly line on, select it for mobile data, and turn on Data Roaming for that line only. Follow [Just landed? How to activate your eSIM](/installing/when-you-land); the app shows the same steps on your plan page once the eSIM is installed.

## Something not working?

* No **Install on this device** button? Your plan is still being set up — it usually takes under five minutes. See [I paid but can't see my eSIM](/troubleshooting/before-you-go/cant-see-my-esim).
* iOS showed an error or nothing happened? See [My eSIM won't install](/troubleshooting/before-you-go/wont-install).
* Installing on someone else's iPhone? Use [a QR code](/installing/iphone/qr-code-or-manual) instead.
