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

🛠️ Step-by-Step Node Setup

🔁 Step 1: Clone the QIE Repository

cd $HOME
sudo apt-get install wget
wget https://github.com/qieadmin/qiev3-mainnet/releases/download/v3/qiemainnetv3.zip
unzip qiemainnetv3.zip
cd QIEV3Mainnet

🧭 Step 2: Add the Binary to Your PATH

In the QIEV3Mainnet directory, run:

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

This allows you to use qied globally from anywhere.


🧰 Step 3: Initialize the Node

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

Example:

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 :

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.

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.

🔧 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

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:

curl localhost:26657/status

🎉 Step 9: Done!

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

Last updated