Skip to content

Latest commit

 

History

History
124 lines (96 loc) · 3 KB

install.md

File metadata and controls

124 lines (96 loc) · 3 KB

Installation guide

Prerequisites

MacOS

  1. Check python3 version
python3 --version
  1. If you see "zsh: command not found: python3" message, install it:
  • Install homebrew
  • Install python3 using terminal:
brew install python3
  1. Install ledgerblue package:
pip3 install ledgerblue

Linux

  1. Install python3 using terminal:
sudo apt install python3 python3-pip
  1. Add rules to resolve OSError: open failed error:
wget -q -O - https://raw.githubusercontent.com/LedgerHQ/udev-rules/master/add_udev_rules.sh | sudo bash
  1. Install ledgerblue package:
pip install ledgerblue --user

Windows (hardest way)

  1. Install WSL
  2. Install Python3
  3. Open PowerShell in a folder with installer_s.sh file
  4. Connect to wsl:
wsl

  1. Install ledgerblue package:
pip3 install ledgerblue --user
  1. Connect Ledger to computer via USB and unlock by enter PIN
  2. Open Powershell as admin in new window and get a list of connected device:
usbipd list
  1. Find BUSID of Ledger device (in this case BUSID is 2-4)

  1. Attach Ledger to WSL by using BUSID from previous step:
usbipd wsl attach --busid 2-4
  1. Do not disconnect Ledger and stay on apps catalog page before loading Substrate app is finished

Load app to Ledger device

  1. Go to latest release page
  2. Download installer_s.sh for Ledger Nano S, or installer_s2.sh for Ledger Nano S Plus
  3. Connect Ledger device to computer via USB
  4. Unlock Ledger and go to catalog of apps screen
  5. Execute installer script:
  • On Linux:
chmod +rwx installer_s.sh 
installer_s.sh load
  • On Mac OS:
/bin/bash installer_s.sh load
  • On Windows:
wsl
sudo ./installer_s.sh load

You will receive a "No dongle found" error message if any of these conditions are not met:

  • Ledger device is connected to a computer via a USB
  • Ledger device is unlocked
  • A page of apps catalog is opened on Ledger

Confirmation installation on Ledger

On the Ledger device, you will see these pages:

Click the left button and select "Allow unsafe manager":

App will be loaded to Ledger device:

After app loading is finished, the page "Install app Substrate" will be open:

Click twice the left button and select "Perform installation":

Enter PIN to confirm installation:

After confirmation app will be ready to use: