Running iOS and Android Dev Apps

Sections in this article

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

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.

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