Fix connection issues

You may encounter connection issues when trying to connect your Ledger Nano S device. If this occurs, try the solutions in this article.

Video instructions

Instructions

Close other applications (Ledger apps, crypto wallets, Geth, Parity, Mist, Bitcoin Core, etc).
Turn OFF VPN and anti-virus temporarily. If that works, make sure to whitelist Ledger Live.
Change the USB cable if possible. Try removing any dongles or docks you're using.
Try different USB ports.
Restart your computer.
Try another computer.

If the problem persists, please select your system below.

Windows

Right-click on Ledger Live to run it as Administrator.
Error code 38
1. Navigate to Windows > Settings > Update and Security > Troubleshoot > Run the troubleshooter
2. The troubleshooter will detect USB Composite Device has error, possibly multiple times. Select one and continue.
3. Select Apply this fix
4. Repeat for other USB Composite Device has error errors. Then restart the computer.
Update USB input device drivers
1. Open Devices and Printers from Control Panel.
2. Double-click Nano S and open the Hardware tab.
3. Select USB Input Device and click Properties.
4. Click Change Settings.
5. Click the Driver tab.
6. Click Update driver and select automatic driver selection.
7. Repeat this for both USB Input Devices.
If it still does not work, please try on a Mac to verify that your Ledger Nano S is working properly.

Mac

Enable full disk access

Open System Preferences.
Go to Security & Privacy.
In the Privacy tab, add Ledger Live to the Full Disk Access list.

Reset PRAM or NVAM

Another solution is to reset the PRAM or NVRAM on your Mac. Follow Apple's official instructions to do so before you retry in Ledger Live.

Linux

On Linux you need to create a set of udev rules to allow device access. Refer to the Chrome USB API documentation for details. Please follow the instructions below.

1. Add the udev rules

Enter the following command to automatically add the rules and reload udev:

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

Retry connecting your Ledger Nano S with Ledger Live.

If it's still not working, continue to step 3: troubleshooting.

2. Troubleshooting

Try each of the following three options.

Option 1
Edit the file /etc/udev/rules.d/20-hw1.rules file by adding the OWNER="<user>" parameter to each line, where <user> is your Linux user name.
Then reload the rules as follows:
```
udevadm trigger
udevadm control --reload-rules
```
Retry the connection with Ledger Live. If it does not work, try the next option.

Option 2
Edit the /etc/udev/rules.d/20-hw1.rules file and add the following lines:

KERNEL=="hidraw*", SUBSYSTEM=="hidraw", MODE="0660", GROUP="plugdev", ATTRS{idVendor}=="2c97"

KERNEL=="hidraw*", SUBSYSTEM=="hidraw", MODE="0660", GROUP="plugdev", ATTRS{idVendor}=="2581"

Then reload the rules:

udevadm trigger
udevadm control --reload-rules

Retry connecting with Ledger Live. If it does not work yet, try the last option.

Option 3
If you are on Arch Linux, you can try the following rules:

/etc/udev/rules.d/20-hw1.rules

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="1b7c", MODE="0660", TAG+="uaccess", TAG+="udev-acl"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="2b7c", MODE="0660", TAG+="uaccess", TAG+="udev-acl"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="3b7c", MODE="0660", TAG+="uaccess", TAG+="udev-acl"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="4b7c", MODE="0660", TAG+="uaccess", TAG+="udev-acl"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="1807", MODE="0660", TAG+="uaccess", TAG+="udev-acl"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="1808", MODE="0660", TAG+="uaccess", TAG+="udev-acl"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2c97", ATTRS{idProduct}=="0000", MODE="0660", TAG+="uaccess", TAG+="udev-acl"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2c97", ATTRS{idProduct}=="0001", MODE="0660", TAG+="uaccess", TAG+="udev-acl"
 SUBSYSTEMS=="usb", ATTRS{idVendor}=="2c97", ATTRS{idProduct}=="0004", MODE="0660", TAG+="uaccess", TAG+="udev-acl"
 SUBSYSTEMS=="usb", ATTRS{idVendor}=="2c97", ATTRS{idProduct}=="1011", MODE="0660", GROUP="plugdev"
 SUBSYSTEMS=="usb", ATTRS{idVendor}=="2c97", ATTRS{idProduct}=="1015", MODE="0660", GROUP="plugdev"

Then reload the rules again and retry the connection with Ledger Live:
```
udevadm trigger
udevadm control --reload-rules
```
Still not working after following all the steps correctly? Please contact Ledger Support.