Everything you need to go from zero to running a fully synced Oraichain node β the right way.
π§° Prerequisites
Before diving in, make sure your system meets the following requirements.
β
OS Compatibility
Ubuntu LTS versions only: 22.04
β Not supported: Ubuntu 16.04 or older
β
Go (Golang)
Required version: 1.22.6+
Follow the if not already installed.
Ensure $GOPATH/bin
is included in your $PATH
.
β
Essential Packages
Install these if not already available:
sudo apt update && sudo apt install make gcc -y
ποΈ Build oraid
from Source
Letβs compile the node binary from scratch.
1. Set your ORAI working directory
export ORAI_HOME="/root"
π If you're not using /root
, replace all occurrences of $ORAI_HOME
with your desired path.
2. Clone and build
cd $ORAI_HOME
git clone https://github.com/oraichain/wasmd
cd wasmd
git checkout v0.50.9 # or latest tag
make build
β οΈ Confirm the binary version:
Expected output: v0.50.9
βοΈ Initialize Your Node
oraid init NODE_NAME --home $ORAI_HOME/.oraid --chain-id Oraichain
(replace the NODE_NAME with a name of your choosing)
Download the latest genesis file:
wget -O $ORAI_HOME/.oraid/config/genesis.json https://raw.githubusercontent.com/oraichain/oraichain-static-files/master/genesis.json
β
Resulting directory structure:
$ORAI_HOME/.oraid/
βββ config
β βββ app.toml
β βββ client.toml
β βββ config.toml
β βββ genesis.json
β βββ node_key.json
β βββ priv_validator_key.json
βββ data
βββ priv_validator_state.json
π§ Setup Cosmovisor (Optional but Recommended)
Cosmovisor makes future upgrades smooth and stress-free.
1. Install Cosmovisor
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest
2. Set up folders
mkdir -p $ORAI_HOME/.oraid/cosmovisor/genesis/bin
mkdir -p $ORAI_HOME/.oraid/cosmovisor/upgrades
cp $GOPATH/bin/oraid $ORAI_HOME/.oraid/cosmovisor/genesis/bin
3. Add environment variables
echo "# Cosmovisor Setup" >> ~/.profile
echo "export ORAI_HOME=/root" >> ~/.profile
echo "export DAEMON_NAME=oraid" >> ~/.profile
echo "export DAEMON_HOME=$ORAI_HOME/.oraid" >> ~/.profile
echo "export DAEMON_ALLOW_DOWNLOAD_BINARIES=false" >> ~/.profile
echo "export DAEMON_LOG_BUFFER_SIZE=512" >> ~/.profile
echo "export DAEMON_RESTART_AFTER_UPGRADE=true" >> ~/.profile
echo "export UNSAFE_SKIP_BACKUP=true" >> ~/.profile
source ~/.profile
Check installation:
cosmovisor version
oraid version
βοΈ Sync Chain Data
Download and extract the latest snapshot:
sudo apt install wget liblz4-tool aria2 -y
cd $ORAI_HOME/.oraid
wget -O oraichain_latest.tar.lz4 [SNAPSHOT_URL]
lz4 -c -d oraichain_latest.tar.lz4 | tar -x -C $ORAI_HOME/.oraid
We provide a snapshot file every hour, available at https://snapshot.orai.io/. Please change [SNAPSHOT_URL] to the provided link.
π οΈ Update Node Config
Edit config:
vim $ORAI_HOME/.oraid/config/config.toml
Update seeds:
seeds = "e18f82a6da3a9842fa55769955d694f62f7f48bd@seed1.orai.zone:26656,defeea41a01b5afdb79ef2af155866e122797a9c@seed4.orai.zone:26656"
You may also add more from this list:
f223f1be06ef35a6dfe54995f05daeb1897d94d7@seed-node.mms.team:42656
8542cd7e6bf9d260fef543bc49e59be5a3fa9074@seed.publicnode.com:26656
fe0a0d46eb5436905bf8465f83d2da5a503bf4eb@mainnet-seed.konsortech.xyz:33165
ade4d8bc8cbe014af6ebdf3cb7b1e9ad36f412c0@seeds.polkachu.com:23356
5f5cfac5c38506fbb4275c19e87c4107ec48808d@seeds.nodex.one:11210
49165f4ef94395897d435f144964bdd14413ea28@seed.orai.synergynodes.com:26656
...
π§ Run as a Systemd Service
Create a service file:
cat > /tmp/orai.service <<EOF
[Unit]
Description=Oraichain Cosmovisor Node
After=network-online.target
[Service]
User=$USER
Environment="ORAI_HOME=/root"
Environment="DAEMON_NAME=oraid"
Environment="DAEMON_HOME=${ORAI_HOME}/.oraid"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_LOG_BUFFER_SIZE=512"
Environment="UNSAFE_SKIP_BACKUP=true"
ExecStart=$GOPATH/bin/cosmovisor run start --home ${ORAI_HOME}/.oraid --minimum-gas-prices=0.001orai
Restart=always
RestartSec=3
LimitNOFILE=infinity
LimitNPROC=infinity
[Install]
WantedBy=multi-user.target
EOF
sudo mv /tmp/orai.service /etc/systemd/system/orai.service
Enable and start:
sudo systemctl daemon-reload
sudo systemctl start orai
sudo systemctl enable orai
π©Ί Monitor Your Node
Check service status
sudo systemctl status orai
View logs live
journalctl -u orai -f
Sync status
oraid status | jq .SyncInfo
# OR
curl -s localhost:26657/status | grep "catching_up"
β
If catching_up
is false
, you're fully synced!
Join our Telegram group to get help, share ideas, and stay up to date:
Some useful resource from validator community: