Mac Users | Developers

Mac Users

Estimated reading time: 3 minutes

Nano X

The Nano X does not support side loading, therefore you must use the device emulator Speculos for loading to work. See how to install and use it.

Nano S and S Plus

1. Install ledgerblue

ledgerblue is a package that contains Python tools to communicate with Ledger devices and manage applications life cycle. It is recommended to install this package in a Virtual Environment in your native environment (not a Docker image) to avoid hidapi issues.

Required packages

First, make sure you have installed these packages:

  • libudev-dev
  • libusb-1.0-0-dev
  • python-dev (required only for python 2.7)
  • virtualenv

ledgerblue package

Outside of your application folder, install the ledgerblue package in a virtual environment:

virtualenv ledger
source ledger/bin/activate
pip install ledgerblue

2. Clone the SDK

The Nano S or S Plus SDK must first be locally cloned and stored in BOLOS_SDK for the loading to work.

Use the following commands for the Nano S:

git clone nanos-secure-sdk
export BOLOS_SDK=<path-to>nanos-secure-sdk

For the Nano S Plus:

git clone nanosplus-secure-sdk
export BOLOS_SDK=<path-to>nanosplus-secure-sdk

3 Load and delete

Before loading an application, make sure you have enough space on the device.


  1. Connect and unlock the Nano S or Nano S Plus.
  2. Go to the root of app‑boilerplate file and activate the Virtual Environment with source ./venv/bin/activate.
  3. Use make load to load the app to the Nano S or Nano S Plus. Your will be asked to “Approve unsafe manager”, it is normal.
  4. You can exit the Virtual Environment with the command deactivate.


  1. Connect and unlock the Nano S or Nano S Plus.
  2. Go to the root of app‑boilerplate
  3. Type make delete to delete it

Did you find this page helpful?

How would you improve this page for developers?

Linux users
Application Debug
Getting Started
Theme Features

Embedded Apps