Beware of phishing attacks, Ledger will never ask for the 24 words of your recovery phrase. Never share them. Learn more

Set up and use polkadot.js to access your Ledger Kusama (KSM) account

 Ongoing issues affecting Polkadot (DOT)/Kusama (KSM) ecosystem

A recent network upgrade has affected some functionality for Ledger users throughout the DOT/Kusama ecosystem, these issues may affect Kusama (KSM) users interacting with the Ledger device. 

If you are experiencing issues interacting with your Kusama (KSM) using a ledger device, you can connect to Talisman wallet to complete whatever operation you might be having issues with.

If connecting to Talisman doesn't work, feel free to reach out to Ledger support.

This tutorial describes how to set up and use the polkadot.js app with your Ledger device to access your Ledger Kusama (KSM) account. 

Before you start

  • Ensure the latest version of the Kusama (KSM) app is installed on your Ledger device.
  • Update the firmware of your Ledger Nano SNano S Plus / Nano X.
  • Ensure that Ledger Live is closed as it can conflict with polkadot.js.
  • Please note that polkadot.js does not support Ledger devices on Firefox. Please ensure you are using Chrome or Brave.

Connect your device to polkadot.js

  1. Unlock your Ledger device and open the Kusama app.
  2. Go to polkadot.js.
  3. Select the tile.
    The next page may take some time to load.
  4. Click the Polkadot logo to open the side panel.
  5. Select Kusama and click Switch to move to KSM wallet.
  6. Click again on the Kusama logo to open the side panel and make sure that you're connected via Parity.
  7. Close the panel by clicking on the (X) button.
  8. Navigate to Settings, select manage hardware connections, and then choose one of the following:
  9. Navigate to Settings, select manage hardware connections, and then choose one of the following:
    • Attach Ledger via WebUSB if you are on Windows.

    • Attach Ledger via WebHID if you are on macOS or Linux.

  10. Click Save.


Add KSM account

  1. In the top header, go to Accounts.
  2. In the drop-down menu, click Accounts.
  3. Select Add via Ledger.
  4. In the subsequent menu, enter a name in the Name field, then leave Account type and Address index as they are. Click Save.
    A pop-up window may appear.
  5. To confirm the connection with your Ledger device, select your device then click Connect.
    Your Ledger Kusama (KSM) account appears.


Next steps

Was this article helpful?