Mac Users

Estimated reading time: 3 minutes

Sections in this page

• Nano X
• Nano S and S Plus
  • 1. Install ledgerblue
    • Required packages
    • ledgerblue package
  • 2. Clone the SDK
  • 3 Load and delete

Nano X

  Important
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
deactivate

2. Clone the SDK

  Important
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 https://github.com/LedgerHQ/nanos-secure-sdk.git nanos-secure-sdk
export BOLOS_SDK=<path-to>nanos-secure-sdk

For the Nano S Plus:

git clone https://github.com/LedgerHQ/nanos-secure-sdk.git nanosplus-secure-sdk
export BOLOS_SDK=<path-to>nanosplus-secure-sdk

3 Load and delete

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

Load:

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.

Delete:

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?

I am a developer.
Contributors will be chosen randomly to receive rewards. Check this box to send your email and participate.

Ledger collects your email address to send you rewards for your contribution to improve the Developer Portal documentation. Learn more about how we manage your data and your rights.

By providing your email address, you consent that Ledger may contact you for rewards delivery purposes. If you are part of the randomly selected contributors, we will send you an email to ask for your physical address and if necessary, ask you for additional information on the suggestion you made. Your information will only be available to Ledger and will be retained for no longer than 90 days. It may be transferred to non-European countries that ensure an adequate level of protection or under the standard contractual clauses adopted by the EU Commission.

Please note that you may withdraw your consent at any time, access your data and request their rectification or deletion. You may also request the limitation of the processing of your data. To exercise your rights or for any question on the processing of your data, please contact LEDGER’s Data Protection Officer here. If nevertheless you believe LEDGER did not adequately address your concerns and mishandled your data, you may lodge a complaint with the personal data protection authority of your country.

Linux users

← Previous

Application Debug

Next →