You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at master.

Reset Your Password

  1. Obtain the latest copy of embassyOS by downloading it from Github. Under Assets near the bottom of the page, click to download eos.tar.gz (on Linux/MacOS) or (on Windows).

  2. Flash the downloaded image to your microSD card, using this guide.

  3. Insert the microSD card into your Embassy and power it on.


    Embassy will power up and then initialize. Once complete, you will hear a _bep_ to indicate it is initialized and then a _chime_ sound to indicate it is online.

  4. On your computer, open up a browser and go to http://embassy.local.

  5. Select “Recover”.

  6. Select “Use Existing Drive”.

  7. As instructed, plug in your embassyOS data drive and it will be detected.



    If your SSD does not show up, unplug it from the USB port and plug it back in a different (blue) USB 3.0 port

  8. Wait a moment while it reads the data from your drive.

  9. Enter and confirm a new password of at least 12 characters when prompted. Save this password somewhere safe.

  10. Your password change is complete!