> For the complete documentation index, see [llms.txt](https://xeqmlabs.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xeqmlabs.gitbook.io/docs/documentation/guides/mainnet/cli-wallet/create-open-your-wallet/restore-wallet-from-seed-phrase-private-key.md).

# Restore Wallet from Seed Phrase (Private Key)

If you already have a wallet seed phrase (mnemonic phrase) and want to restore it, you can do so using the `--restore-deterministic-wallet` option. This is useful if you:

* Lost your wallet file but have your seed phrase
* Want to restore your wallet on a different computer
* Need to recover your wallet after reinstalling

**Important:** Make sure your service node is running before restoring the wallet!

#### Windows (PowerShell)

**Step 1: Open PowerShell and navigate to your testnet folder**

```
cd C:\Users\YourUsername\Desktop\xeq-testnet
```

(Replace `YourUsername` with your Windows username and adjust the path if your testnet folder is in a different location)

**Step 2: Stop and remove the old wallet container (if it exists)** If you have an old wallet file you want to replace:

```
docker stop sn01
docker rm sn01
```

**Note:** Only do this if you want to start fresh. If you just want to restore to a new wallet file, skip this step and use a different wallet filename in Step 3.

**Step 3: Restore your wallet from seed phrase**

```
docker exec -it sn01 /usr/local/bin/xeq-wallet-cli --testnet --restore-deterministic-wallet --wallet-file=/data/sn01 --password=my_password --daemon-address=127.0.0.1:18091
```

**Replace:**

* `my_password` with the password you want to use for this wallet
* `/data/sn01` with a different path if you want to create a new wallet file (e.g., `/data/sn01-restored`)

**Step 4: Enter your seed phrase**

* The wallet CLI will prompt you: `Enter mnemonic phrase:`
* Type your seed phrase (the 25 words separated by spaces)
* Press **Enter**

**Step 5: Enter restore height (optional)**

* The wallet will ask: `Enter restore height (optional, default 0):`
* Press **Enter** to use default (0) - this will restore from the beginning
* Or enter a specific block height if you know when your wallet was created (this speeds up restoration)

**Step 6: Wait for restoration**

* The wallet will restore and start syncing
* This may take some time depending on the restore height

**Step 7: Verify your wallet** Once restored, type:

```
address
```

This should show your wallet address. Verify it matches the address you expect.

#### Linux (Terminal)

**Step 1: Open Terminal and navigate to your testnet folder**

```
cd ~/Desktop/xeq-testnet
```

(Replace with your actual testnet folder path if different)

**Step 2: Stop and remove the old wallet container (if it exists)** If you have an old wallet file you want to replace:

```
docker stop sn01
docker rm sn01
```

**Note:** Only do this if you want to start fresh. If you just want to restore to a new wallet file, skip this step and use a different wallet filename in Step 3.

**Step 3: Restore your wallet from seed phrase**

```
docker exec -it sn01 /usr/local/bin/xeq-wallet-cli --testnet --restore-deterministic-wallet --wallet-file=/data/sn01 --password=my_password --daemon-address=127.0.0.1:18091
```

**Replace:**

* `my_password` with the password you want to use for this wallet
* `/data/sn01` with a different path if you want to create a new wallet file (e.g., `/data/sn01-restored`)

**Step 4: Enter your seed phrase**

* The wallet CLI will prompt you: `Enter mnemonic phrase:`
* Type your seed phrase (the 25 words separated by spaces)
* Press **Enter**

**Step 5: Enter restore height (optional)**

* The wallet will ask: `Enter restore height (optional, default 0):`
* Press **Enter** to use default (0) - this will restore from the beginning
* Or enter a specific block height if you know when your wallet was created (this speeds up restoration)

**Step 6: Wait for restoration**

* The wallet will restore and start syncing
* This may take some time depending on the restore height

**Step 7: Verify your wallet** Once restored, type:

```
address
```

This should show your wallet address. Verify it matches the address you expect.

#### Important Notes

* **Keep your seed phrase safe!** Never share it with anyone. Anyone with your seed phrase can access your funds.
* **Restore height:** If you know approximately when your wallet was created (block height), entering it will speed up the restoration process. Otherwise, use 0 to restore from the beginning.
* **Wallet file location:** The wallet file will be saved at `/data/sn01.keys` inside the Docker container (or whatever path you specified with `--wallet-file`).
* **Password:** You'll need to remember the password you set during restoration to open the wallet in the future.
* **Service node registration:** If you're restoring a wallet that was used for a service node, make sure the wallet address matches your registered service node address.