> For the complete documentation index, see [llms.txt](https://docs.qie.digital/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qie.digital/getting-started-with-qie-blockchain/1.-how-to-run-a-full-node-on-qie-v3.md).

# ⚙️ 1. How to Run a Full Node on QIE V3

### 🛠️ Step-by-Step Node Setup

#### 🔁 Step 1: Clone the QIE Repository

```bash
cd $HOME
sudo apt-get install wget
wget https://github.com/qieadmin/qiev3-mainnet/releases/download/v3/qiemainnetv3.zip
unzip qiemainnetv3.zip
cd QIEV3Mainnet
rm -rf qied
wget https://github.com/qieadmin/qiev3-mainnet/releases/download/v4/qied
chmod +x qied
```

***

#### 🧭 Step 2: Add the Binary to Your PATH

In the QIEV3Mainnet directory, run:

```bash
sudo cp -r ./qied /usr/bin
cd $HOME
```

This allows you to use `qied` globally from anywhere.

***

#### 🧰 Step 3: Initialize the Node

```bash
qied init --chain-id="<chain-id>" <node-name> --home "<path-to-config>"
```

**Example:**

```bash
qied init --chain-id="qie_1990-1" fullnode --home "$HOME/.qieMainnetNode"
```

This will generate the required structure in `~/.`qieMainnetNode, including:

* `config/` – blockchain config files
* `data/` – block data

***

#### 🧾 Step 4: Replace the Genesis File

Delete the auto-generated genesis file and other files as well :

```bash
rm -rf  $HOME/.qieMainnetNode/config/genesis.json
rm -rf  $HOME/.qieMainnetNode/config/config.toml
rm -rf  $HOME/.qieMainnetNode/config/client.toml
rm -rf  $HOME/.qieMainnetNode/config/app.toml
```

#### 🧾 Step 5: Replace the Genesis File and others.

```bash
cp -r $HOME/QIEV3Mainnet/genesis.json $HOME/.qieMainnetNode/config
cp -r $HOME/QIEV3Mainnet/config.toml $HOME/.qieMainnetNode/config
cp -r $HOME/QIEV3Mainnet/client.toml $HOME/.qieMainnetNode/config
cp -r $HOME/QIEV3Mainnet/app.toml $HOME/.qieMainnetNode/config
```

Then, copy the `genesis.json` and other Necesories files from your existing Node 1 and place it here.

***

#### 🧾 Step 6: Set a Name for Your Full Node

To personalize and identify your full node on the QIE Mainnet, you need to set a unique name (moniker). This name will be visible on the [QIE Validators Page](https://mainnet.qie.digital/validators).

**🔧 Edit the Configuration File**

Run the following command to open the configuration file in the terminal:

```
nano $HOME/.qieMainnetNode/config/config.toml
```

Inside the file, locate the following line:

```
moniker = "<Add_your_name>"
```

Replace `"<Add_your_name>"` with your preferred **unique** node name. This will serve as your validator identity on the network.

> 💡 **Tip:** Choose a recognizable and meaningful name, especially if you plan to become a validator.

**💾 Save and Exit**

After editing the line:

1. Press `Ctrl + X` to exit.
2. Press `Y` to confirm saving the changes.
3. Hit `Enter` to finalize and close the file.

Your node name has now been successfully updated!

#### ▶️ Step 7: Start the Node

```bash
qied start --home "$HOME/.qieMainnetNode"
```

Your node will begin syncing with the network.

***

#### ⏳ Step 8: Wait for Full Sync

You’ll see blocks being synced in logs.

You can also verify sync status using:

```bash
curl localhost:26657/status
```

***

### 🎉 Step 9: Done!

Congratulations — your QIE full node is now successfully running and connected to the network.

<br>