How to intitialize your Ledger Wallet with GreenAddress Services

Warning/Update 01/2017: This initialisation mode with a HEX seed is supported only via command line now. To obtain the same result initialise your HW1/NANO via python command line tools and once setup proceed to use the device with GreenAddress. Alternatively you can create a regular mnemonic wallet and from settings setup your HW1/NANO.

Caution: Initializing your hardware wallet with GreenAddress will wipe any other wallets already there.

To initialize your Ledger Nano with the GreenAddress wallet, you have to do this with the Chrome application.

Once you have installed the application start it up and plug in your Ledger.


In the screenshot we can see “Log in via hardware wallet”, but this will only work if you are already initialized and registered with GreenAddress services. Instead click on the “Create Wallet” link.


On this screen you see the normal mnemonics page. What we’re interested in here is the little button pictured in the bottom right corner of the mnemonics form. Clicking this will initiate the hardware wallet setup workflow.


If you already have a wallet set up beforehand from any other service in addition to GreenAddress, you will be warned of this in the dialogue. If you wish to wipe the device (you backed up your other wallet seed, right?!), click the “Reset my BTChip” button. This will start the wiping process, which will involve the user unplugging and replugging the device enough times to wipe it. The trick is that the smart card will be wiped after 3 consecutive incorrect PIN tries, so it simply enters in an incorrect PIN repeatedly until it is wiped.

Once you are finished with this you are ready to initialize your new seed.


Click “Set up BTChip”


Enter your super secret PIN. Make sure to remember this!


Hmm, boring message. Wait, don’t click yet! Read this whole message.


Normally for other devices such as Trezor the wallet mnemonic is derived directly on the hardware wallet. One tradeoff here is the Ledger wallet is based on smart card technology. While bank-security safe, they are much less powered than a general microcontroller. This means instead of a string of words as our backup, we will be backing up the raw seed.

You read the pop-up, right?

To continue, open up a text editor of your choice, and un-plug, then re-plug the device. Your seed will be output automatically. The seed will consist of the word “Seed”, followed by a long word comprised of hex and an ‘X’ at the end. Here is a  representative sample:


If it doesn’t follow the described pattern, you may have a defective Ledger and will not be able to use it to recover. You will need this seed if GreenAddress goes down or your Ledger is lost or broken to recover your funds. Copy it. Put it somewhere safe. GreenAddress can not help you recover your funds if you fail to save this information!

After you have followed the directions and clicked “Close”, you are brought back to the mnemonics screen, with a major difference.


As you can see, the mnemonics are no longer being displayed since the application doesn’t even know what it is, and we can check the box and click continue. From there you are registered and can sign up for 2FA. Registering for E-mail notifications for both incoming and outgoing transactions will allow you to recover your funds with the Gentle tool if something goes wrong and is highly recommended.

Congratulations! Now you are a hardware wallet muti-sig user and can take advantage of the full power of GreenAddress services!