Support Docs

Solving a MetaMask connection issue

Using your Ledger device with Metamask can be a tricky task. In this article, you will learn a few tips that can help you connect your device to Metamask.

A few important tips before we start

Most Metamask issues can be avoided by observing the following tips.
Please review this list carefully then try connecting your Ledger device to Metamask again.

  • We strongly recommend using Metamask with the Firefox browser because it does not require using the Ledger Live bridge.
  • Ensure that Metamask is up to date. More on this here.
  • Ensure that Ledger Live is closed otherwise it might prevent your Ledger device from connecting to Metamask.
  • Open the Ethereum (ETH) app on your Ledger device before clicking the "Connect Hardware Wallet" button in Metamask.
  • Ensure that your Ledger device runs the latest firmware version. You can learn more here (Nano S users) or here (Nano X users).
  • Ensure that your Ledger device is running the latest version of the Ethereum (ETH) app. Learn more here.
  • Ensure that blind signing is enabled in the Ethereum app settings on your Ledger device. Learn more here.

new_mm_oct_2021.gif

Using the Ledger Live bridge

The Ledger Live bridge is a safe way to connect Metamask to your Ledger device via Ledger Live. Using the bridge is only required on Chrome or on any Chromium-based browsers (Brave, Opera, Edge).

Mac

MetaMask has implemented a device bridge that allows you to connect your Ledger device to MetaMask through Ledger Live.

  1. Click on the MetaMask icon in the upper right corner of your web browser.

    Device bridge

  2. Click on your profile icon in the upper right corner, then go to Settings > Advanced
  3. Scroll down to Use Ledger Live
  4. Click on the toggle to enable the Ledger Live bridge. 
  5. Click on your profile icon, then select Connect Hardware Wallet
  6. Select Ledger, then click on Connect.
    An Open Ledger Live? window appears.
  7. Click Open Ledger Live.
    Once Ledger Live opens, an Open Device Bridge window appears. You are asked to allow a WebSocket connection to your MetaMask account.
  8. Click Open.

You have successfully activated the bridge between Ledger Live and MetaMask. You can now access your accounts in MetaMask.

Linux
The workaround implemented by MetaMask doesn’t work for users on Linux. We are currently working on a fix which will be communicated soon.
Windows
If you are on Windows, you are not affected by this issue since Windows includes a native U2F stack. But if you are experiencing connection issues with MetaMask, you can try to activate the bridge between Ledger Live and MetaMask. This bridge allows you to connect your Ledger device to MetaMask through Ledger Live.
  1. Click on the MetaMask icon in the upper right corner of your web browser.

    Device bridge

  2. Click on your profile icon in the upper right corner, then go to Settings > Advanced
  3. Scroll down to Use Ledger Live
  4. Click on the toggle to enable the Ledger Live bridge. 
  5. Click on your profile icon, then select Connect Hardware Wallet
  6. Select Ledger, then click on Connect.
    An Open Ledger Live? window appears.
  7. Click Open Ledger Live.
    Once Ledger Live opens, an Open Device Bridge window appears. You are asked to allow a Websocket connection to your MetaMask account.
  8. Click Open.

You have successfully activated the bridge between Ledger Live and MetaMask. You can now access your accounts in MetaMask.

Consider using WalletConnect instead of Metamask

WalletConnect offers a safe alternative to Metamask for connecting your Ledger device to Ethereum DApps. You can learn more about it here.