Manual Installation

DISCLAIMER: This guide is for informational purposes only. Always verify steps with official documentation and ensure you fully understand each action before proceeding.

This guide will install the latest version and cannot sync from block 0. Therefore, you must use a snapshot. If you want to sync manually from 0 please use this guide.

Hardware requirement

CPU : 8cores Memory : 64GB Storage : 1TB NVMe SSD Bandwidth : 100mps for Download / Upload

1. System updates, installation of required environments:

sudo apt update
sudo apt install curl git make jq build-essential gcc unzip wget lz4 aria2 -y

2. Install Go:

cd $HOME && \
ver="1.22.0" && \
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" && \
sudo rm -rf /usr/local/go && \
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" && \
rm "go$ver.linux-amd64.tar.gz" && \
[ ! -f ~/.bash_profile ] && touch ~/.bash_profile && \
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> ~/.bash_profile && \
source ~/.bash_profile && \
go version

3. Git clone:

cd $HOME
rm -rf 0g-chain
git clone https://github.com/0glabs/0g-chain.git
cd 0g-chain
git checkout v0.3.1
git submodule update --init
make install
0gchaind version

4. Variable settings:

Replace "your_node_name", "wallet_name"

echo "export WALLET='josephtran'" >> $HOME/.bash_profile
echo "export MONIKER='JosephTran'" >> $HOME/.bash_profile
echo "export OG_CHAIN_ID='zgtendermint_16600-2'" >> $HOME/.bash_profile
echo "export OG_PORT='26'" >> $HOME/.bash_profile
source $HOME/.bash_profile

5. Node init:

0gchaind config keyring-backend os
0gchaind config chain-id $OG_CHAIN_ID
0gchaind init $MONIKER --chain-id $OG_CHAIN_ID
0gchaind config node tcp://localhost:${OG_PORT}657

6. Download genesis.json file:

rm ~/.0gchain/config/genesis.json
wget -P ~/.0gchain/config https://github.com/0glabs/0g-chain/releases/download/v0.2.3/genesis.json

7. Custom port setting (Optional)

If you use default PORT, do not need set this step!

sed -i -e "
s%:1317%:${OG_PORT}317%g;
s%:8080%:${OG_PORT}080%g;
s%:9090%:${OG_PORT}090%g;
s%:9091%:${OG_PORT}091%g;
s%:8545%:${OG_PORT}545%g;
s%:8546%:${OG_PORT}546%g;
s%:6065%:${OG_PORT}065%g
" $HOME/.0gchain/config/app.toml

sed -i -e "
s%:26658%:${OG_PORT}658%g;
s%:26657%:${OG_PORT}657%g;
s%:6060%:${OG_PORT}060%g;
s%:26656%:${OG_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${OG_PORT}656\"%;
s%:26660%:${OG_PORT}660%g
" $HOME/.0gchain/config/config.toml

8. PEERS, SEED setting:

SEEDS="[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,8f21742ea5487da6e0697ba7d7b36961d3599567@og-testnet-seed.itrocket.net:47656"
PEERS="80fa309afab4a35323018ac70a40a446d3ae9caf@og-testnet-peer.itrocket.net:11656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656,[email protected]:12656"
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
       -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" $HOME/.0gchain/config/config.toml

Update live peers:

PEERS=$(curl -s -X POST https://rpc-0gchain.josephtran.xyz -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"net_info","params":[],"id":1}' | jq -r '.result.peers[] | select(.connection_status.SendMonitor.Active == true) | "\(.node_info.id)@\(if .node_info.listen_addr | contains("0.0.0.0") then .remote_ip + ":" + (.node_info.listen_addr | sub("tcp://0.0.0.0:"; "")) else .node_info.listen_addr | sub("tcp://"; "") end)"' | tr '\n' ',' | sed 's/,$//' | awk '{print "\"" $0 "\""}')

sed -i "s/^persistent_peers *=.*/persistent_peers = $PEERS/" "$HOME/.0gchain/config/config.toml"

if [ $? -eq 0 ]; then
    echo -e "Configuration file updated successfully with new peers"
else
    echo "Failed to update configuration file."
fi

9. Config pruning, set gas price, enable prometheus, disable indexer:

sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.0gchain/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.0gchain/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"50\"/" $HOME/.0gchain/config/app.toml

sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.00025ua0gi"|g' $HOME/.0gchain/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.0gchain/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.0gchain/config/config.toml

10. Create service file

sudo tee /etc/systemd/system/0gd.service > /dev/null <<EOF
[Unit]
Description=0G Node
After=network.target
[Service]
User=$USER
Type=simple
ExecStart=$(which 0gchaind) start --home $HOME/.0gchain
Restart=on-failure
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF

With 0gchaind version v0.3.1 you cannot sync from Block height 1. You need download a snapshot with above Block height 616,000

11. Download snapshot

Snapshot

12. Service execution:

sudo systemctl daemon-reload && \
sudo systemctl enable 0gd && \
sudo systemctl restart 0gd && sudo systemctl status 0gd

Check log

tail -f ~/.0gchain/log/chain.log

13. Check Latest Block Height:

0gchaind status | jq '{ latest_block_height: .sync_info.latest_block_height, catching_up: .sync_info.catching_up }'

*You will have to wait a while until it syncs

# Block sync left:

while true; do 
  local_height=$(0gchaind status | jq -r .sync_info.latest_block_height); 
  network_height=$(curl -s https://0gchain.josephtran.xyz/status | jq -r '.result.sync_info.latest_block_height')
  blocks_left=$((network_height - local_height)); 
  echo -e "\033[1;38mYour node height:\033[0m \033[1;34m$local_height\033[0m | \033[1;35mNetwork height:\033[0m \033[1;36m$network_height\033[0m | \033[1;29mBlocks left:\033[0m \033[1;31m$blocks_left\033[0m"; 
  sleep 5; 
done

You can see your node's latsest_block_height like below (Or you can check catching_up is false) If the block height is set, you can create validator.

14. Wallet config, check EVM address:

Add new wallet:

0gchaind keys add "wallet_name" --eth

Or recover by seed phrase

0gchaind keys add "wallet_name" --eth --recover

*Replace your "wallet_name"

*Important: write your mnemonic phrase in a safe place

Export to evm address:

0gchaind keys unsafe-export-eth-key "wallet_name"

15. Faucet token:

Faucet link: https://faucet.0g.ai/

16. Check Balance & Create Validator & Check Validator:

Check balance:

0gchaind q bank balances $(0gchaind keys show "wallet_name" -a)

Create Validator:

0gchaind tx staking create-validator \
  --amount=100ua0gi \
  --pubkey=$(0gchaind tendermint show-validator) \
  --moniker="Your_node_name" \
  --chain-id=zgtendermint_16600-2 \
  --commission-rate="0.10" \
  --commission-max-rate="0.20" \
  --commission-max-change-rate="0.01" \
  --details="0G to the moon" \
  --min-self-delegation="1" \
  --from="wallet_name" \
  --gas=auto \
  --gas-adjustment=1.4 \
  --gas-prices 0.00252ua0gi \
  -y

Backup the validator key:

File location: /root/.0gchain/config/priv_validator_key.json
Copy this file to your local machine.
Store it carefully; this is the most crucial key for your validator.

Check Validator:

0gchaind q staking validator $(0gchaind keys show "wallet_name" --bech val -a)

Delegate:

0gchaind tx staking delegate $(0gchaind keys show <your_wallet> --bech val -a) 1000000ua0gi \
--from <your_wallet> \
--chain-id=zgtendermint_16600-2 \
--gas=auto \
--gas-adjustment=1.4 \
--gas-prices 0.00252ua0gi \
-y

PreviousValidator Node NextCosmovisor

Last updated 1 year ago

hashtagHardware requirement

hashtag1. System updates, installation of required environments:

hashtag2. Install Go:

hashtag3. Git clone:

hashtag4. Variable settings:

hashtag5. Node init:

hashtag6. Download genesis.json file:

hashtag7. Custom port setting (Optional)

hashtag8. PEERS, SEED setting:

hashtag9. Config pruning, set gas price, enable prometheus, disable indexer:

hashtag10. Create service file

hashtag11. Download snapshot

hashtag12. Service execution:

hashtag13. Check Latest Block Height:

hashtag# Block sync left:

hashtag14. Wallet config, check EVM address:

hashtagAdd new wallet:

hashtagOr recover by seed phrase

hashtagExport to evm address:

hashtag15. Faucet token:

hashtag16. Check Balance & Create Validator & Check Validator:

hashtagCheck balance:

hashtagCreate Validator:

hashtagCheck Validator:

hashtagDelegate:

Hardware requirement

1. System updates, installation of required environments:

2. Install Go:

3. Git clone:

4. Variable settings:

5. Node init:

6. Download genesis.json file:

7. Custom port setting (Optional)

8. PEERS, SEED setting:

9. Config pruning, set gas price, enable prometheus, disable indexer:

10. Create service file

11. Download snapshot

12. Service execution:

13. Check Latest Block Height:

# Block sync left:

14. Wallet config, check EVM address:

Add new wallet:

Or recover by seed phrase

Export to evm address:

15. Faucet token:

16. Check Balance & Create Validator & Check Validator:

Check balance:

Create Validator:

Check Validator:

Delegate: