Running iOS and Android Dev Apps | Developers

Running iOS and Android Dev Apps

Estimated reading time: 2 minutes

This article explains how to run a Ledger Live dev app for iOS on macOS.


For iOS: Building iOS build. For Android: Building Android build.

Connecting to Nano S / X / S Plus

In this part, we’ll connect a Ledger Nano S to the application, using the ledger-live-common proxy feature.

You need nvm to install and use node version 12. Installation details are here.

Once installed, open a new terminal and type:

nvm install 12 (if not already done)
nvm use 12

Then clone the ledger-live-common repo:

git clone
cd ledger-live-common/cli

Now, launch the ledger-live-common proxy command:

node bin/index.js proxy

The expected output is:

  • Open the LL [DEV] application on the simulator
  • Choose “Ledger Nano X” as the device (even if you’re going to use a Nano S)
  • “Use initialized device” […] → Settings
  • On the Ledger logo, click very rapidly until the “Debug” menu appears (a mouse is recommended, as it’s virtually impossible with a trackpad).
  • Go to “Debug http transport” and copy-paste the IP address given previously by ledger-live-common

Once that is done, an onboarding page pops up.

  • Connect your Nano, and choose the Ledger Nano X device once again
  • Go through the setup

Congratulations! You have successfully connected your device

Testing on the Nano

  • On your ledger-live-mobile directory, double-click on the ledgerlivemobile.xcworkspace file.

It opens XCode. Switch back to the Xcode toolchain (Xcode → Toolchains → Xcode xx.x)

You may want to change the default scheme to either build a debug or a release version (Product → Scheme → Edit Scheme…):

  • Connect your device to your mac
  • Select it as the target

You can try to launch a build. If it fails because of a problem with a certificate, then:

  • Under the ledgerlivemobile menu, go to “Signing & Capabilities”
  • Click “Revoke Certificate”, XCode will automatically create a new one
  • Try to build it a second time. It works!

If you need to export the .ipa file, click on Product → Archive After the build is complete you should have this window displayed:

  • Click on Distribute App → Development → Next → Automatically manage signing
  • Export it to the folder you want to save it in.

You can then do without Xcode or a developer account to install the iOS app by using “Apple Configurator 2”. Download it from the Apple store.

Did you find this page helpful?

How would you improve this page for developers?

Building Android Dev App
General CLI Checklist - User tests
Getting Started
Theme Features