Skip to content
This repository has been archived by the owner on Mar 1, 2024. It is now read-only.

Latest commit

 

History

History
54 lines (34 loc) · 3.65 KB

README.md

File metadata and controls

54 lines (34 loc) · 3.65 KB
Raw

Warning

⚠️ This repository is archived and not updated anymore.

The backup Web-app sources now lie into the app-passwords repository (./clients/wui/ directory).

Live Web-app (from develop branch) is deployed here.

Passwords Backup

Live demo here

What is this Web App ?

This Web App allows you to backup/restore the list of password nicknames stored inside the Passwords app on your Ledger Nano S/ Nano X. It is useful to have such a backup when you update the Passwords app on your device, or the device firmware, because the list gets erased.

Another case where it's practical to have a nickname backup is when you loose your device: Restoring the 24-words recovery phrase is necessary but not sufficient to restore your passwords, you need your nickname list as well.

The backup consists in a human readable backup.json file containing a dump of the 4096 bytes of application storage.

Note that all operations of this Web App are done locally on your computer, there are no external communications occuring.

What is the Ledger Passwords application ?

Look here for more information on the device application itself.

How to use this Web App ?

  • Install the Passwords app on your Nano S/ Nano X from the Ledger Live.
  • Connect your Nano S/Nano X to your computer and open the Passwords app.
  • You can now click on the big Connect button, and if it succeeds the Backup/Restore buttons should appear in place of the previous button. If you have troubles with this step, have a look here. \n* Either click on Backup/Restore depending on what you want to do.
    • Backup will prompt a screen requesting your approval on your device (\"Transfer metadatas ?\"), then save a backup file. This is your backup. it's not confidential, so for instance you can send it to yourself by e-mail to never loose it.
    • Restore will prompt a file input dialog where you should indicate a previous backup file. A prompt (\"Overwite metadatas ?\") will then request your approval on your device.

Which web browsers are supported ?

The communication with the device is done through WebUSB, which is curently supported only on Google Chrome / Chromium / Brave for Linux and MacOS. On Windows, Zadig is required.

Less common use cases

  • If you ever encounter a WTF-kind of error with your passwords app (some or all of your entries are suddenly gone? A password has changed ?), it is wise to first come here and make a backup. You can then have a look inside the backup file to see if something is wrong (You might also want to create an issue here so we fix your issue for all users).
  • If you want to add a lot of new passwords, the manual input on the device keyboard will show its limits. You can instead create a backup and edit it manually to add all your new entries. You just have to restore your app with this file and the job is done :)

Building the project

yarn start

Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.

Credits

This WebApp was bootstrapped with Create React App.