Set up the Ledger device and install the Concordium Ledger App#

To be able to sign and send transactions using the Desktop Wallet, you need a Ledger 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.

Note

The Ledger Nano X is not supported currently.

Prerequisites#

  • Ledger hardware wallet

Warning

During the process described in this guide, you’ll generate private keys on the Ledger 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 device#

The Ledger device 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 or Nano S Plus.

  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 for your device. The Concordium Ledger App currently supports Ledger firmware version 2.1.0 for the Ledger Nano S and 1.0.3 for Ledger Nano S Plus.

Update the Ledger device firmware#

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

  1. On the Ledger press both buttons for a little while until the Settings icon appears. Press both buttons to enter the Settings menu.

  2. On the Nano S Plus press both buttons on the General menu item.

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

  4. Press both buttons to view the Secure Element version.

    • For Nano S, if it says 2.1.0, you don’t have to update the firmware. If there’s a lower version number, you’ll have to update the firmware.

    • For Nano S Plus, if it says 1.0.3, 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 Nano S guide or Ledger Nano S Plus guide.

Once you have updated the firmware version, you can download the Ledger app at Downloads.

Follow the instructions below to update your app:

It should not be necessary to update the certificate.

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.

Restart your computer, and then confirm that Python and Pip were installed.

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

  2. To confirm that Python3 was installed, enter

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

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

    $pip 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. Now you need to start recovery mode on the Ledger device.

    • On the Nano S, press the right button and hold it down while you reconnect the Ledger to the computer until the Ledger says recovery.

    • On the Nano S Plus, press the left button and hold it down while you reconnect the Ledger to the computer. Navigate to Recovery mode and press both buttons to enter recovery mode.

  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.

Update the Concordium Ledger app on Windows#

For the app to work properly with the current version of the Desktop Wallet, make sure that you update to the latest version of the app.

Note

Before updating, verify that you have installed Python3, pip, and the Python tools for Ledger (ledgerblue) before updating the app.

  1. Download the latest version of the Ledger app if you haven’t done so already.

  2. 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.

  3. 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.

  4. Before you can install the new version of the Ledger app, you have to uninstall the old one. The Ledger says Uninstall Concordium. Press the right button to navigate through the identifier until the Ledger says Confirm action. Press both buttons to confirm. The Ledger says Loading, please wait while it installs the app.

  5. The Ledger says Concordium. Press both buttons. The Ledger says Concordium is ready. Press the left button to verify that you’ve installed the latest version of the Ledger app.

Install Concordium Ledger app on macOS#

Install Homebrew, Python3, and pip#

  1. Open the Terminal application.

  2. Navigate to where you have downloaded the Ledger install package. For example, this might be ~/Downloads/concordium-ledger-app-2.0.1-target-2.0.0. To navigate to this directory in a Terminal, enter cd ~/Downloads/concordium-ledger-app-2.0.1-target-2.0.0.

  3. Install the package manager Homebrew; you will need the Homebrew tool to install the remaining dependencies. Copy the following line into the Terminal and press enter.

    $/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  4. To install Python3, Pip3, libusb, and libjpeg, copy the following into the Terminal and press Enter:

    $brew install [email protected] libusb libjpeg
    

    You can use pyenv<https://github.com/pyenv/pyenv> if you need multiple python versions. Installing libjpeg is only necessary if you have a Mac with an M1 or similar Apple Silicon CPU.

  5. To install ledgerblue, copy the following into the Terminal and press Enter:

    $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. Now you need to start recovery mode on the Ledger device.

    • On the Nano S, press the right button and hold it down while you reconnect the Ledger to the computer. The Ledger says recovery mode.

    • On the Nano S Plus, press the left button and hold it down while you reconnect the Ledger to the computer. Navigate to Recovery mode and press both buttons to enter recovery mode.

  6. Enter your PIN code.

  7. Open the Terminal application.

  8. Navigate to where you have downloaded the Ledger install package. For example, this might be ~/Downloads/concordium-ledger-app-2.0.1-target-2.0.0. To navigate to this directory in a Terminal, enter cd ~/Downloads/concordium-ledger-app-2.0.1-target-2.0.0.

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

    $./loadcertificate.sh
    
  10. 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.

  11. 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.

  12. Enter your PIN.

Install the Concordium Ledger app on MacOS#

  1. Open the Terminal application.

  2. Navigate to where you have downloaded the Ledger install package. For example, this might be ~/Downloads/concordium-ledger-app-2.0.1-target-2.0.0. To navigate to this directory in a Terminal, enter cd ~/Downloads/concordium-ledger-app-2.0.1-target-2.0.0.

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

    $./install.sh
    
  4. 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.

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

Update/reinstall the Concordium Ledger app on macOS#

For the app to work properly with the current version of the Desktop Wallet, make sure that you update to the latest version of the app.

When you update your Ledger, it should not be necessary to update the certificate.

Note

If you’re using a different computer than the one you used when you installed the app, you must install Python3, pip, and the Python tools tools for Ledger (ledgerblue) before updating the app.

  1. Download the latest version of the Ledger app if you haven’t done so already.

  2. Open the Terminal application.

  3. Navigate to where you have downloaded the Ledger install package. For example, this might be ~/Downloads/concordium-ledger-app-2.0.3-target-2.1.0. To navigate to this directory in a Terminal, enter cd ~/Downloads/concordium-ledger-app-2.0.3-target-2.1.0.

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

    ./install.sh
    
  5. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager.

  6. Before you can install the new version of the Ledger app, you have to uninstall the old one. The Ledger says Uninstall Concordium. Press the right button to navigate through the identifier until the Ledger says Confirm action. Press both buttons to confirm. The Ledger says Loading, please wait while it installs the app.

  7. The Ledger says Concordium. Press both buttons. The Ledger says Concordium is ready. Press the left button to verify that you’ve installed the latest version of the Ledger app.

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. Now you need to start recovery mode on the Ledger device.

    • On the Nano S, press the right button and hold it down while you reconnect the Ledger to the computer. The Ledger says recovery mode.

    • On the Nano S Plus, press the left button and hold it down while you reconnect the Ledger to the computer. Navigate to Recovery mode and press both buttons to enter 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.

Update the Concordium Ledger app on Ubuntu#

For the app to work properly with the current version of the Desktop Wallet, make sure that you update to the latest version of the app.

Note

If you’re using a different computer than the one you used when you installed the app, you must install Python3, pip, and the Python tools for Ledger (ledgerblue) before updating the app.

  1. Download the latest version of the Ledger app if you haven’t done so already.

  2. Run the install.sh file from the folder that you extracted the files to.

  3. The Ledger says Deny unsafe manager. Press the right button to navigate through the public key until the Ledger says Allow unsafe manager.

  4. Before you can install the new version of the Ledger app, you have to uninstall the old one. The Ledger says Uninstall Concordium. Press the right button to navigate through the identifier until the Ledger says Confirm action. Press both buttons to confirm. The Ledger says Loading, please wait while it installs the app.

  5. The Ledger says Concordium. Press both buttons. The Ledger says Concordium is ready. Press the left button to verify that you’ve installed the latest version of the Ledger app.