> For the complete documentation index, see [llms.txt](https://stavr-team.gitbook.io/nodes-guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stavr-team.gitbook.io/nodes-guides/mainnets/oraichain/node-installation.md).

# Node Installation

## [EXPLORER](https://explorer.stavr.tech/Orai-Mainnet)

* **Minimum hardware requirements**:

| Node Type | CPU | RAM  | Storage |
| --------- | --- | ---- | ------- |
| Mainnet   | 8   | 16GB | 250GB   |

## 1) Auto\_install script

```bash
source <(curl -s https://raw.githubusercontent.com/111STAVR111/props/refs/heads/main/Oraichain/oraim)
```

## 2) Manual installation

#### Preparing the server

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc git jq chrony liblz4-tool -y
```

### GO 1.21.6

```bash
ver="1.21.6"
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"
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
go version
```

## Build 21.07.25

```bash
cd $HOME && mkdir -p go/bin/
git clone https://github.com/oraichain/wasmd/
cd wasmd
git checkout orai-v0.50.12
make build
```

`oraid version --long | grep -e commit -e version`

* version: 0.50.12
* commit: 227473993ac6de3646231c9efb46777ac9d57805

## Initiation

```python
oraid init STAVR_guide --chain-id=Oraichain
oraid config chain-id Oraichain
```

### Create/recover wallet

```bash
oraid keys add <walletname>
           OR
oraid keys add <walletname> --recover
```

### Download Addrbook and Genesis

```bash
wget -O $HOME/.oraid/config/addrbook.json "https://server-3.stavr.tech/Mainnet/Orai/addrbook.json"
wget -L -O $HOME/.oraid/config/genesis.json https://server-3.stavr.tech/Mainnet/Orai/genesis.json
```

`sha256sum $HOME/.oraid/config/genesis.json`

* fc8995cee38cdcc545ea903e2ae2a5843477139bba6b0b9adc0010f77b3767d8

### Set up the minimum gas price and Peers/Seeds/Filter peers/MaxPeers

```bash
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0orai\"/;" ~/.oraid/config/app.toml
sed -i -e "s/^filter_peers *=.*/filter_peers = \"true\"/" $HOME/.oraid/config/config.toml
external_address=$(wget -qO- eth0.me) 
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.oraid/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.oraid/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.oraid/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.oraid/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 10/g' $HOME/.oraid/config/config.toml
```

#### Pruning (optional)

```bash
pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="10"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.oraid/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.oraid/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.oraid/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.oraid/config/app.toml
```

#### Indexer (optional)

```bash
indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.oraid/config/config.toml
```

## Create a service file

```bash
sudo tee /etc/systemd/system/oraid.service > /dev/null <<EOF
[Unit]
Description=oraid
After=network-online.target

[Service]
User=$USER
ExecStart=$(which oraid) start --home $HOME/.oraid
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF
```

## StateSync Oraichain Mainnet

```bash
systemctl stop oraid
SNAP_RPC=https://orai.rpc.m.stavr.tech:443
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 1000)); \
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH

sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \
s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"| ; \
s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.oraid/config/config.toml
oraid tendermint unsafe-reset-all --home /root/.oraid
wget -O $HOME/.oraid/config/addrbook.json "https://server-3.stavr.tech/Mainnet/Orai/addrbook.json"
curl -o - -L https://orai.wasm.stavr.tech/wasm-orai.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.oraid
sudo systemctl restart oraid && journalctl -fu oraid -o cat
```

## SnapShot Mainnet updated every 5 hours

{% hint style="success" %}
<https://server-3.stavr.tech/Mainnet/Orai/>
{% endhint %}

```bash
cd $HOME
apt install lz4
sudo systemctl stop oraid
cp $HOME/.oraid/data/priv_validator_state.json $HOME/.oraid/priv_validator_state.json.backup
rm -rf $HOME/.oraid/data
LATEST_SNAPSHOT=$(curl -s https://server-3.stavr.tech/Mainnet/Orai/ | grep -oE 'orai-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-3.stavr.tech/Mainnet/Orai/${SNAPSHOT%.tar.lz4}-info.txt" | awk '/Block height:/ {print $3}'); echo "$SNAPSHOT $HEIGHT"; done | sort -k2 -nr | head -n 1 | awk '{print $1}')
curl -o - -L https://server-3.stavr.tech/Mainnet/Orai/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.oraid
curl -o - -L https://orai.wasm.stavr.tech/wasm-orai.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.oraid
mv $HOME/.oraid/priv_validator_state.json.backup $HOME/.oraid/data/priv_validator_state.json
wget -O $HOME/.oraid/config/addrbook.json "https://server-3.stavr.tech/Mainnet/Orai/addrbook.json"
sudo systemctl restart oraid && journalctl -fu oraid -o cat
```

### Start

```bash
sudo systemctl daemon-reload
sudo systemctl enable oraid 
sudo systemctl restart oraid && sudo journalctl -fu oraid -o cat
```

#### Create validator

```python
oraid tx staking create-validator \
--commission-rate 0.1 \
--commission-max-rate 1 \
--commission-max-change-rate 1 \
--min-self-delegation "1" \
--amount 1000000orai \
--pubkey $(oraid tendermint show-validator) \
--from <wallet> \
--moniker="STAVR_guide" \
--chain-id Oraichain \
--gas 300000 \
--fees 30000umed \
--identity="" \
--website="" \
--details="" -y
```

## [🧩Services and Tools🧩](https://stavr-team.gitbook.io/nodes-guides/mainnets/oraichain/statesync-snapshot)

## Monitoring

You can set up your node status alarm here - [Monitoring](https://stavr-team.gitbook.io/nodes-guides/monitoring)

## Security

You can create secure management of your wallet and your node by following this links.

[TMKMS](https://stavr-team.gitbook.io/nodes-guides/tmkms)               [Wallet Security](https://stavr-team.gitbook.io/nodes-guides/wallet-security)

### Delete node

```bash
sudo systemctl stop oraid
sudo systemctl disable oraid
rm /etc/systemd/system/oraid.service
sudo systemctl daemon-reload
cd $HOME
rm -rf orai
rm -rf .oraid
rm -rf $(which oraid)
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://stavr-team.gitbook.io/nodes-guides/mainnets/oraichain/node-installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.