Manage your device with ledgerctl

Estimated reading time: One minute

Sections in this page

• Installation
  • 1. Install ledgerctl
  • 2. Install a custom certificate authority (optional)
• Usage

Installation

1. Install ledgerctl

Run:

pip3 install --upgrade protobuf setuptools ecdsa
pip3 install ledgerwallet

And:

git clone https://github.com/LedgerHQ/ledgerctl.git
pip3 install --upgrade protobuf setuptools ecdsa
cd ledgerctl
pip install -e .

2. Install a custom certificate authority (optional)

Optionally, install a custom certificate authority (this will help to establish a custom secure channel between the computer and the device, and identifies ledgerctl as a “trusted manager” on the device):

• a. To install a custom CA, boot the device in “Recovery” mode by pressing the right button at boot time.
• b. Then run ledgerctl install-ca <NAME> where is the name that will be displayed on the device to identify the CA. It can be any label, like "ledgerctl", "Dev", or "CA".

The Ledger device will display to you a public key. Allow the “unsafe manager” on the device by pressing at the time the right and left buttons.

Usage

You’re now ready to use ledgerctl to manage your Nano.

To display the list of the application installed on your device:

ledgerctl list 

To display the available space on the device:

ledgerctl meminfo

To delete an app (for example “Bitcoin Legacy”):

ledgerctl delete "Bitcoin Legacy"

---

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.

Mac Users

← Previous

Application Debug

Next →