diff --git a/docs/src/.gitbook/assets/ledger-live-enable-developer-mode.png b/docs/src/.gitbook/assets/ledger-live-enable-developer-mode.png new file mode 100644 index 0000000000..296fab7d21 Binary files /dev/null and b/docs/src/.gitbook/assets/ledger-live-enable-developer-mode.png differ diff --git a/docs/src/.gitbook/assets/ledger-live-install-solana-app.png b/docs/src/.gitbook/assets/ledger-live-install-solana-app.png new file mode 100644 index 0000000000..46986a69e7 Binary files /dev/null and b/docs/src/.gitbook/assets/ledger-live-install-solana-app.png differ diff --git a/docs/src/remote-wallet/ledger.md b/docs/src/remote-wallet/ledger.md index 8a221d5cdd..b17f0e8839 100644 --- a/docs/src/remote-wallet/ledger.md +++ b/docs/src/remote-wallet/ledger.md @@ -6,64 +6,8 @@ secure transaction signing. ## Before You Begin +- [Set up a Ledger Nano S with the Solana App](../wallet/ledger-live.md) - [Install the Solana command-line tools](../cli/install-solana-cli-tools.md) -- [Initialize your Ledger Nano S](https://support.ledger.com/hc/en-us/articles/360000613793) -- [Install the latest device firmware](https://support.ledgerwallet.com/hc/en-us/articles/360002731113-Update-Ledger-Nano-S-firmware) - -## Install the Solana App on Ledger Nano S - -The Solana Ledger app is not yet available on Ledger Live. Until it is, you -can install a development version of the app from the command-line. Note that -because the app is not installed via Ledger Live, you will need to approve -installation from an "unsafe" manager, as well as see the message, "This app -is not genuine" each time you open the app. Once the app is available on -Ledger Live, you can reinstall the app from there, and the message will no -longer be displayed. - -1. Connect your Ledger device via USB and enter your pin to unlock it -2. Download and run the Solana Ledger app installer: - ```text - curl -sSLf https://github.com/solana-labs/ledger-app-solana/releases/download/v0.1.1/install.sh | sh - ``` -3. When prompted, approve the "unsafe" manager on your device -4. When prompted, approve the installation on your device -5. An installation window appears and your device will display Processing… -6. The app installation is confirmed - -### Troubleshooting - -If you encounter the following error: - -```text -Traceback (most recent call last): - File "/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.7/lib/python3.7/runpy.py", line 193, in _run_module_as_main - "__main__", mod_spec) - File "/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.7/lib/python3.7/runpy.py", line 85, in _run_code - exec(code, run_globals) - File "ledger-env/lib/python3.7/site-packages/ledgerblue/loadApp.py", line 197, in - dongle = getDongle(args.apdu) - File "ledger-env/lib/python3.7/site-packages/ledgerblue/comm.py", line 216, in getDongle - dev.open_path(hidDevicePath) - File "hid.pyx", line 72, in hid.device.open_path -OSError: open failed -``` - -To fix, check the following: - -1. Ensure your Ledger device is connected to USB -2. Ensure your Ledger device is unlocked and not waiting for you to enter your pin -3. Ensure the Ledger Live application is not open - -### Future: Installation once the Solana app is on Ledger Live - -- [Install Ledger Live](https://support.ledger.com/hc/en-us/articles/360006395553/) software on your computer - -1. Open the Manager in Ledger Live -2. Connect your Ledger device via USB and enter your pin to unlock it -3. When prompted, approve the manager on your device -4. Find Solana in the app catalog and click Install -5. An installation window appears and your device will display Processing… -6. The app installation is confirmed ## Use Ledger Device with Solana CLI diff --git a/docs/src/wallet/ledger-live.md b/docs/src/wallet/ledger-live.md index 92f77e5a19..cef32c4fe0 100644 --- a/docs/src/wallet/ledger-live.md +++ b/docs/src/wallet/ledger-live.md @@ -16,6 +16,7 @@ line tools](../remote-wallet/ledger.md). - Order a [Nano S from Ledger](https://shop.ledger.com/products/ledger-nano-s) - Follow the instructions for device setup included in the package, or [Ledger's Start page](https://www.ledger.com/start/) +- [Install the latest device firmware](https://support.ledgerwallet.com/hc/en-us/articles/360002731113-Update-Ledger-Nano-S-firmware) ##Install Ledger Live - Install [Ledger Live desktop software](https://www.ledger.com/ledger-live/), @@ -30,11 +31,14 @@ line tools](../remote-wallet/ledger.md). - Open Ledger Live - Currently Ledger Live needs to be in "Developer Mode" (Settings > Experimental Features > Developer Mode) to see our app. + ![Enabling Developer Mode](../.gitbook/assets/ledger-live-enable-developer-mode.png) + - Go to Manager in the app and find "Solana" in the App Catalog and click Install - Make sure your device is plugged in via USB and is unlocked with its PIN - You may be prompted on the Nano S to confirm the install of Solana App - "Solana" should now show as "Installed" in the Ledger Live Manager + ![Installed Solana App in Manager](../.gitbook/assets/ledger-live-install-solana-app.png) ##Interact with Solana network - To interact with your Ledger wallet on our live network, please see our