How to install the Alephium App in your Ledger Nano S
🚨 This tutorial is exclusively for the Nano S. If you have a Ledger version that is NOT the Nano S, (S+, X, Flex or Stax) you must use the Ledger Live to download the Alephium app, please follow the (much easier) instructions here.
🚨We encourage you to migrate to a more recent device, as Ledger is not actively supporting anything related to the Nano S anymore!
⚠️ Important information: This sideloading method requires downloading other software on your computer and has several manual technical steps. Proceed only if you are sure that you understand how to perform this operation!
Installation instructions for Ledger Nano S
1–Download the latest release from: Chrome /Firefox
2 — Install the necessary software (if you already have PIP & Python installed, jump to step 3)
You will need Python and PIP installed on your computer to get the Alephium App on your Ledger:
- Python (how to for Windows, how to for Mac, how to for Linux)
- PIP (how to for Windows, how to for Mac, how to for Linux)
3 — Install the Ledger Python Library
We are going to use the Ledger Python Library (you can find it here). It is necessary because you are going to install a custom App onto your Ledger Device.
To install the Ledger Python Library open a terminal window and type the following:
pip3 install — — upgrade protobuf setuptools ecdsa
pip3 install ledgerwallet
This will make all upgrades and install the Ledger Wallet Library needed for the next step.
4 — Download the Alephium Ledger App to your computer
Go to the following GitHub repository: https://github.com/alephium/ledger-alephium and download it.
🚨To download the repository, click on the “Code” green button and choose “Download Zip.”
Download and unzip it in a folder you have easy access to and all read/write permissions.
5 — Install the Alephium App on your Ledger Device
Your Ledger now needs to be connected to your computer and unlocked.
Go to the GitHub repository (https://github.com/alephium/ledger-alephium/tree/master) and scroll down to find the command that applies to your Ledger version:
With this information, go to the console terminal and run the command to install the Alephium App:
🚨 Important information: You need to run the command inside the folder you downloaded the files from GitHub.
After running this command, you must validate the Alephium App installation on your Ledger Device. Go through all approvals and add your PIN to validate the installation.
When successful, the Alephium icon will appear on your device.
Now, you are ready to use your Ledger to sign transactions on Alephium! 🎉
6 — Use your Ledger with the Extension Wallet
Go to the browser where you installed the browser extension wallet, and open it.
🚨 The Ledger app only works with the latest version of the extension wallet for now. If you don’t have it, you can install it from here.
Create a new address in your extension wallet: Click on the current address name, and then in the “+” icon. That will lead you to Ledger Connection page:
- Plug in your Ledger and unlocked it;
- Open the Alephium App (make sure you validated all steps!)
- Select your Ledger device from the list;
- Finish the configuration.
If you want to see in more details on how to send transactions, use dapps or do more complex tasks, you’ll find everything in the ledger docs here & here.
If you have questions or suggestions, please come to Alephium’s Discord, Telegram, or reach out on Twitter!