Skip to content
Snippets Groups Projects
Select Git revision
  • gl-pages
  • master default protected
2 results
Blame Permalink
Forked from monero-project / monero-site
683 commits behind the upstream repository.
ledger-wallet-cli.md 11.43 KiB

{% assign version = '1.1.0' | split: '.' %} {% include disclaimer.html translated="false" version=page.version %}

How to generate a Ledger Monero wallet with the CLI (monero-wallet-cli)

Table of Content

1. Windows

We first have to ensure that we're sufficiently prepared. This entails the following:

  1. This guide assumes you have already initialized your Ledger wallet and thus generated a 24 word mnemonic seed.

  2. You need to run / use CLI v0.12.2.0, which can be found here.

  3. You need to install the Ledger Monero app and configure your system. Instructions can be found here (sections 3.1.1 and 3.2.3 in particular). In addition, make sure to set the network to Mainnet

  4. Your Ledger needs to be plugged in and the Ledger Monero app should be running.

  5. Either your daemon (monerod.exe) should be running and preferably be fully synced or you should connect to a remote node.

Now that we're sufficiently prepared, let's start!

  1. Go to the directory / folder monerod.exe and monero-wallet-cli.exe are located.

  2. Open a new command prompt / powershell. This is done by first making sure your cursor isn't located on any of the files and subsequently doing SHIFT + right click. It will give you an option to "Open command window here". If you're using Windows 10 in latest version, it'll give you an option to "open the PowerShell window here".

  3. Now type:

monero-wallet-cli.exe --generate-from-device <new-wallet-name> --subaddress-lookahead 3:200 (Win 7 + 8)

.\monero-wallet-cli.exe --generate-from-device <new-wallet-name> --subaddress-lookahead 3:200 (Win 10)

Note that is simply a placeholder for the actual wallet name. If you, for instance, want to name your wallet MoneroWallet, the command would be as follows:

monero-wallet-cli.exe --generate-from-device MoneroWallet --subaddress-lookahead 3:200 (Win 7 + 8)

.\monero-wallet-cli.exe --generate-from-device MoneroWallet --subaddress-lookahead 3:200 (Win 10)

  1. The CLI will, after executing aforementioned command, prompt your for a password. Make sure to set a strong password and confirm it thereafter.

  2. The Ledger will ask whether you want to export the private view key or not. First and foremost, your funds cannot be compromised with merely the private view key. Exporting the private view key enables the client (on the computer - Monero v0.12.2.0) to scan blocks looking for transactions that belong to your wallet / address. If this option is not utilized, the device (Ledger) will scan blocks, which will be significantly slower. There is, however, one caveat. That is, if your system gets compromised, the adversary will potentially be able to compromise your private view key as well, which is detrimental to privacy. This is virtually impossible when the private view key is not exported.

  3. You may have to hit confirm twice before it proceeds.

  4. Your Ledger Monero wallet will now be generated. Note that this may take up to 5-10 minutes. Furthermore, there will be no immediate feedback in the CLI nor on the Ledger.

  5. monero-wallet-cli will start refreshing. Wait until it has fully refreshed.

Congratulations, you can now use your Ledger Monero wallet in conjunction with the CLI.

2. Mac OS X

We first have to ensure that we're sufficiently prepared. This entails the following:

  1. This guide assumes you have already initialized your Ledger wallet and thus generated a 24 word mnemonic seed.

  2. You need to run / use CLI v0.12.2.0, which can be found here.

  3. You need to install the Ledger Monero app and configure your system. Instructions can be found here (sections 3.1.1 and 3.2.2 in particular). In addition, make sure to set the network to Mainnet

  4. Note that the instructions for system configuration (section 3.2.2) on Mac OS X are quite elaborate and can be perceived as slightly convoluted. Fortunately, tficharmers has created a guide here that you can use for assistance.

  5. Your Ledger needs to be plugged in and the Ledger Monero app should be running.

  6. Either your daemon (monerod) should be running and preferably be fully synced or you should connect to a remote node.

Now that we're sufficiently prepared, let's start!