mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 10:21:53 +00:00
aed86e7e6c
* re-arrange the user docs * Minor description edit * update styles * fix service links Co-authored-by: kn0wmad <kn0wmad@protonmail.com> Co-authored-by: Lucy Cifferello <12953208+elvece@users.noreply.github.com>
89 lines
2.2 KiB
ReStructuredText
89 lines
2.2 KiB
ReStructuredText
.. _forgot-password:
|
|
|
|
===============
|
|
Forgot Password
|
|
===============
|
|
|
|
There is currently no way to reset you Embassy master password through a standard UI flow.
|
|
|
|
SSH/Linux
|
|
---------
|
|
|
|
If you already have :ref:`SSH keys registered with your Embassy<ssh>` **OR** you have access to a Linux computer, you can reset your Embassy password without losing any data.
|
|
|
|
SSH
|
|
===
|
|
|
|
#. Use the command line to gain SSH access to your Embassy, replacing ``[network-id]`` with your Embassy's unique ID:
|
|
|
|
.. code-block:: bash
|
|
|
|
ssh pi@embassy-[network-id].local
|
|
|
|
#. Check if you have sqlite3 installed (with ``which``). If not, install it (with ``apt``):
|
|
|
|
.. code-block:: bash
|
|
|
|
which sqlite3
|
|
sudo apt install sqlite3
|
|
|
|
#. Access the sqlite3 terminal:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo sqlite3 /root/agent/start9_agent.sqlite3
|
|
|
|
#. Run:
|
|
|
|
.. code-block:: bash
|
|
|
|
delete from account;
|
|
.quit
|
|
|
|
#. Exit the SSH session:
|
|
|
|
.. code-block:: bash
|
|
|
|
exit
|
|
|
|
.. warning:: Running setup process will generate new certificate and Tor address for your Embassy.
|
|
|
|
#. You can now visit ``embassy.local`` to reclaim your Embassy and set a new password.
|
|
|
|
Linux
|
|
=====
|
|
|
|
#. Shut down your Embassy, disconnect from power, and remove the microSD card.
|
|
#. Insert the microSD card into your Linux computer and mount the drive::
|
|
|
|
mount [drive] [mount folder]
|
|
|
|
#. Check if you have sqlite3 installed. If not, install it::
|
|
|
|
which sqlite3
|
|
sudo apt install sqlite3
|
|
|
|
#. Access the sqlite3 terminal::
|
|
|
|
sudo sqlite3 /root/agent/start9_agent.sqlite3
|
|
|
|
#. Run::
|
|
|
|
delete from account;
|
|
.quit
|
|
|
|
#. Un-mount the microSD card::
|
|
|
|
umount [mount folder]
|
|
|
|
#. Return the microSD card to your Embassy and power it on.
|
|
|
|
.. warning:: Running setup process will generate new certificate and Tor address for your Embassy.
|
|
|
|
#. You can now visit ``embassy.local`` to reclaim your Embassy and set a new password.
|
|
|
|
No SSH/Linux
|
|
------------
|
|
|
|
You must factory reset your device by re-installing EmbassyOS, resulting in permanent loss of data. Visit the `image downloader <https://images.start9labs.com/>`_ to obtain a new EmbassyOS image, then follow the :ref:`Initial Setup <initial-setup>` guide.
|