> For the complete documentation index, see [llms.txt](https://docs.qsafewallet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qsafewallet.com/all-features/onboarding.md).

# Onboarding

### Introduction

QSafe Wallet offers users a seamless and secure onboarding experience through a browser extension. Once installed, users are guided step-by-step through either creating a new wallet or restoring an existing one, with user-friendly interfaces and essential security checks.<br>

### Getting Started: Wallet Installation & Launch

After installing the QSafe Wallet extension and launching it, users are redirected to the **Onboarding Page**, where they are greeted with a simple interface containing two options:

1. **Create a New Wallet**
2. **Restore Existing Wallet**

<figure><img src="/files/YNDqhQPfQceHo0k01i35" alt=""><figcaption></figcaption></figure>

**(i) Creating a New Wallet**

#### Step 1: Create a Password

* The first step is to **create a strong password** for protecting the wallet.
* This password is essential for accessing the wallet locally.
* ⚠️ **Important:** This password **cannot be recovered**. Users are advised to store it securely.

<figure><img src="/files/8xFxOencH8aHwQ79VEZj" alt=""><figcaption></figcaption></figure>

#### Step 2: Confirm the Password

* Users must **re-enter the password** to confirm it was typed correctly and remembered.
* This validation ensures the user is aware of the exact password used.

<figure><img src="/files/qBn3hGPtBMZh2WLFnk7x" alt=""><figcaption></figcaption></figure>

#### Step 3: Mnemonic Phrase Generation

* Upon successful password creation, a **12-word mnemonic phrase** is generated.
* This is a **critical security component** for recovering the wallet in the future.
* Users are instructed to **save this phrase offline**, preferably in a secure, physical location.

<figure><img src="/files/5npebNcqnh1mfBXLFUAZ" alt=""><figcaption></figcaption></figure>

#### Step 4: Mnemonic Phrase Verification

* To ensure the user has **securely stored the phrase**, a short quiz is conducted.
* Example:\
  \&#xNAN;*"Which of the following is the 9th word of your secret phrase?"*\
  Options: `Supply`, `Wire`, `Local`, `Silent`
* The user must **correctly answer** to proceed.

**Once all four steps are completed successfully**, the user is granted full access to the QSafe Wallet and its features.

### (ii) Restore an Existing Wallet

If the user has previously created a wallet and wants to restore it:

#### Step 1: Choose "Restore Existing Wallet"

* On the onboarding screen, the user selects the second option to begin the recovery process.

#### Step 2: Enter Secret Recovery Phrase

* The user is redirected to a screen with a text area.
* They must enter the **12-word mnemonic phrase** from their previous wallet setup.

<figure><img src="/files/cEpOzaUmW6j5dKaTpSn7" alt=""><figcaption></figcaption></figure>

#### Step 3: Create a New Password

* After successfully entering the phrase, the user must **set a new password** for the restored wallet.
* This password is specific to the current device/browser instance.

<figure><img src="/files/Bp2i1Lcvtn8g9TKi2P67" alt=""><figcaption></figcaption></figure>

#### Step 4: Confirm the Password

* The new password is re-entered to ensure correctness and awareness.

**Upon completing these steps**, the wallet is restored successfully, and all previously associated data (accounts, balances, activity) becomes accessible again.

<figure><img src="/files/Opsdb5YaIRPH8Ex5jrej" alt=""><figcaption></figcaption></figure>

Important Notes

* The **12-word mnemonic phrase is the only way to recover the wallet**. QSafe does not store it, and it should never be shared with anyone.
* The **password only protects local access** and **cannot be recovered** if forgotten. Use secure methods to store both the password and mnemonic phrase.
* Screenshots corresponding to each step in both processes should be referenced for visual clarity (as indicated in the source text).