Set up the Ledger Nano S and install the Concordium Ledger App

To be able to sign and send transactions using the Desktop Wallet, you need a Ledger Nano S hardware wallet, and you need to install the Concordium Ledger Application on the Ledger. You can use Windows, macOS or Ubuntu to install the app.

Prerequisites

  • Ledger hardware wallet

Warning

During the process described in this guide, you’ll generate private keys on the Ledger Nano S hardware wallet, and you’ll receive a 24-word recovery phrase. This is the only backup of your private keys. Make sure that you store it securely.

Set up the Ledger Nano S

The Ledger Nano S will generate the unique 24-word recovery phrase that is used to derive your private keys.

  1. Download and install Ledger Live. For information on how to do this, see Ledger’s documentation. You’ll only need Ledger Live when you set up the Ledger and update the firmware.

  2. Open Ledger Live, select Get started, and then select Nano S.

  3. Follow the on-screen setup instructions to set up your PIN code on the Ledger.

  4. Follow the on-screen instructions to get your 24-word recovery phrase.

Warning

Make sure that you write down the recovery phrase precisely as displayed and in the correct order. The recovery phrase is the only backup of your private keys.

Once you’ve set up the Ledger, you must check that it’s running the proper firmware version. The Concordium Ledger App currently only supports Ledger firmware version 2.0.0.

Update the Ledger Nano S firmware

To find out which firmware version the Ledger is running, do the following:

  1. On the Ledger navigate to Settings and press both buttons for a little while to enter the Settings menu.

  2. Press the right button to navigate to Firmware version.

  3. Press both buttons to view the Secure Element version. If it says 2.0.0, you don’t have to update the firmware. If there’s a lower version number, you’ll have to update the firmware.

For details on how to update the Ledger firmware, see Ledger ‘s guide

Install Concordium Ledger app on Windows

Install Python3 and pip

  1. In the Start menu, type store to open the Microsoft store.

  2. In Search, in the upper right corner, enter python.

  3. Select Python 3.9, and then select Install.

    Python is downloaded and installed automatically. Depending on the setup of your computer, you might see a message saying Python 3.9 just got installed.

  4. In the Start menu, type PowerShell and select Windows PowerShell. The command-line window opens.

  5. To confirm that Python3 was installed, enter

    Python3 --version
    
  1. To confirm that the package manager named pip is installed, enter

    pip --version
    
  2. To install Python tools for the Ledger Nano S, enter

    pip3 install ledgerblue
    

Install the custom certificate on Windows

You now have to install a custom certificate on the Ledger to ensure that it trusts applications signed by Concordium’s private key.

  1. Close all applications that might be connected to the Ledger such as Ledger Live and Concordium Desktop Wallet and keep them closed until you’ve completed the steps in this guide.

  2. Disconnect the Ledger from your computer.

  3. Download the ZIP folder with Concordium Ledger application.

  4. Extract the files from the ZIP folder to a folder on your computer.

  5. Press the right button while you reconnect the Ledger to the computer, and hold it down until the Ledger says recovery.

  6. Enter your PIN code.

  7. Open the folder you extracted the files to and double-click the loadcertificate.bat file. If there’s a message saying Windows protected your PC, select More info, and then select Run anyway. A command-line window opens.

  8. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager. Press both buttons. You can safely ignore the message in the command-line window saying Broken certificate chain - loading from user key. This is expected behavior.

  9. The certificate is installed on the Ledger. The Ledger says Certificate concordium. Press the right button to navigate through the key, and then press both buttons when the Ledger says Trust certificate.

  10. Enter your PIN.

Install the Concordium Ledger app on Windows

  1. In the folder that you extracted the files to, double-click the install.bat file. If there’s a message saying Windows protected your PC, select More info, and then select Run anyway.

  2. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager. Press both buttons. The Ledger says Loading, please wait while it installs the app.

  3. The Ledger says Concordium. Press both buttons. The Ledger says Concordium is ready. You can now use the Ledger with the Desktop Wallet.

Install Concordium Ledger app on macOS

Install Homebrew, Python3, and pip

  1. Open the Terminal application. Click the Launchpad icon in the Dock, type Terminal in the search field, then select Terminal.

  2. Install the package manager Homebrew. Copy the following line into the Terminal and press enter.

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  1. Install Python3 and Pip3 to manage (alternatively use pyenv if you need multiple python versions). Copy the following line into the Terminal and press enter:

    brew install [email protected]
    
  2. Install libusb. Copy the following line into the Terminal and press enter:

    brew install libusb
    
  3. If you have Mac with an M1 or similar Apple Silicon CPU, install:

    brew install libjpeg
    
  4. Install ledgerblue:

    pip3 install ledgerblue
    

Install the custom certificate using macOS

You now have to install a custom certificate to ensure that the Ledger trusts applications signed by Concordium’s private key.

  1. Close all applications that might be connected to the Ledger such as Ledger Live and Concordium Desktop Wallet and keep them closed until you’ve completed the steps in this guide.

  2. Download the ZIP folder with the Concordium Ledger application.

  3. Extract the files from the ZIP folder to a folder on your computer.

  4. Disconnect the Ledger from your computer.

  5. Press the right button and hold it down while you reconnect the Ledger to the computer. The Ledger says recovery mode.

  6. Enter your PIN code.

    Load the certificate onto the Ledger by running the following script from the extracted folder:

    ./loadcertificate.sh
    
  7. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager. Press both buttons. You can safely ignore the message in the command-line window saying Broken certificate chain - loading from user key. This is expected behavior.

  8. The certificate is installed on the Ledger. The Ledger says Certificate concordium. Press the right button to navigate through the key, and then press both buttons when the Ledger says Trust certificate.

  9. Enter your PIN.

Install the Concordium Ledger app on MacOS

  1. Install the Concordium application on the Ledger by running the following script from the folder you extracted the files to:

    ./install.sh
    
  1. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager. Press both buttons. The Ledger says Loading, please wait while it installs the app.

  2. The Ledger says Concordium. Press both buttons. The Ledger says Concordium is ready. You can now use the Ledger with the Desktop Wallet.

Install Concordium Ledger app on Ubuntu

Install Python3 and pip on Ubuntu

  1. Add udev rules. For more information, see the Linux section in Ledger ‘s guide Fix connection history.

    wget -q -O - https://raw.githubusercontent.com/LedgerHQ/udev-rules/master/add_udev_rules.sh | sudo bash
    
  1. Install python3:

    sudo apt-get install python3
    
  2. Install pip:

    sudo apt-get install python3-pip
    
  3. Install

    sudo apt-get install libudev-dev libusb-1.0-0-dev python-dev
    
  4. Install ledgerblue:

    sudo pip3 install ledgerblue
    

Install the custom certificate on Ubuntu

You now have to install a custom certificate to ensure that the Ledger trusts applications signed by Concordium’s private key.

  1. Close all applications that might be connected to the Ledger such as Ledger Live and Concordium Desktop Wallet and keep them closed until you’ve completed the steps in this guide.

  2. Download the ZIP folder with the Concordium Ledger application.

  3. Extract the files from the ZIP folder to a folder on your computer.

  4. Disconnect the Ledger from your computer.

  5. Press the right button and hold it down while you reconnect the Ledger to the computer. The Ledger says recovery mode.

  6. Enter your PIN code.

  7. Run the following script from the folder you extracted the files to:

    ./loadcertificate.sh
    
  8. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager. Press both buttons. You can safely ignore the message in the command-line window saying Broken certificate chain - loading from user key. This is expected behavior.

  9. The certificate is installed on the Ledger. Press the right button to navigate through the key, and then press both buttons when the Ledger says Trust certificate.

Install the Concordium Ledger app on Ubuntu

  1. Install the Concordium application on the Ledger by running the following script from the folder you extracted the files to:

    ./install.sh
    
  1. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager. Press both buttons. The Ledger says Loading, please wait while it installs the app.

  2. The Ledger says Concordium. Press both buttons. The Ledger says Concordium is ready. You can now use the Ledger with the Desktop Wallet.

Support & Feedback

If you have questions or feedback, join us on Discourse, or contact us at support@concordium.software.