💾Node Installation
XRPL Mainnet guide
Minimum hardware requirements:
Node Type
CPU
RAM
Storage
Mainnet
4
8GB
150GB
1) Auto_install script
Soon2) Manual installation
Preparing the server
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 -yGO 1.21.6
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 versionBuild 26.07.25
cd $HOME && mkdir -p go/bin/
git clone https://github.com/xrplevm/node.git xrplevm
cd xrplevm
git checkout v8.0.0
make installexrpd version --long | grep -e version -e commit
version: 8.0.0
commit: 8d92d087b9a1014de748b8887868e0e90b97b56f
Initiation
exrpd init STAVR_guide --chain-id xrplevm_144000-1Create/recover wallet
exrpd keys add <walletname>
OR
exrpd keys add <walletname> --recoverDownload Addrbook and Genesis
wget -O $HOME/.exrpd/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Xrpl/addrbook.json"
wget -O $HOME/.exrpd/config/genesis.json "https://server-1.stavr.tech/Mainnet/Xrpl/genesis.json"sha256sum $HOME/.exrpd/config/genesis.json
30a67f83b14b2b0bc8e5427eb56cbe16ce7dfa4bdad98bbfb5d846a459555f2f
Set up the minimum gas price and Peers/Seeds/Filter peers/MaxPeers
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0axrp\"/;" ~/.exrpd/config/app.toml
external_address=$(wget -qO- eth0.me)
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.exrpd/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.exrpd/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.exrpd/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.exrpd/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 50/g' $HOME/.exrpd/config/config.tomlPruning (optional)
pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="10"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.exrpd/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.exrpd/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.exrpd/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.exrpd/config/app.tomlIndexer (optional)
indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.exrpd/config/config.tomlCreate a service file
sudo tee /etc/systemd/system/exrpd.service > /dev/null <<EOF
[Unit]
Description=exrpd
After=network-online.target
[Service]
User=$USER
ExecStart=$(which exrpd) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOFStateSync XRPL Mainnet
systemctl stop exrpd
SNAP_RPC=https://xrpl.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/.exrpd/config/config.toml
exrpd tendermint unsafe-reset-all --home /root/.exrpd
wget -O $HOME/.exrpd/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Xrpl/addrbook.json"
sudo systemctl restart exrpd && journalctl -fu exrpd -n1000 -ocatSnapShot Mainnet updated every 5 hours (Pruned)
cd $HOME
apt install lz4
sudo systemctl stop exrpd
cp $HOME/.exrpd/data/priv_validator_state.json $HOME/.exrpd/priv_validator_state.json.backup
rm -rf $HOME/.exrpd/data
LATEST_SNAPSHOT=$(curl -s https://server-1.stavr.tech/Mainnet/Xrpl/ | grep -oE 'xrpl-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-1.stavr.tech/Mainnet/Xrpl/${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-1.stavr.tech/Mainnet/Xrpl/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.exrpd
mv $HOME/.exrpd/priv_validator_state.json.backup $HOME/.exrpd/data/priv_validator_state.json
wget -O $HOME/.exrpd/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Xrpl/addrbook.json"
sudo systemctl restart exrpd && journalctl -fu exrpd -n1000 -ocatSnapShot Mainnet updated every 3d (Archive)
cd $HOME
apt install lz4
sudo systemctl stop exrpd
cp $HOME/.exrpd/data/priv_validator_state.json $HOME/.exrpd/priv_validator_state.json.backup
rm -rf $HOME/.exrpd/data
LATEST_SNAPSHOT=$(curl -s https://server-3.stavr.tech/Mainnet/Xrpl/ | grep -oE 'xrpl-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-3.stavr.tech/Mainnet/Xrpl/${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/Xrpl/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.exrpd
mv $HOME/.exrpd/priv_validator_state.json.backup $HOME/.exrpd/data/priv_validator_state.json
wget -O $HOME/.exrpd/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Xrpl/addrbook.json"
sudo systemctl restart exrpd && journalctl -fu exrpd -n1000 -ocatStart
sudo systemctl daemon-reload
sudo systemctl enable exrpd
sudo systemctl restart exrpd && journalctl -fu exrpd -n1000 -ocatCreate validator
#pubkey
exrpd tendermint show-validator --home $HOME/.exrpd
cd $HOME
nano $HOME/.exrpd/validator.json
{
"pubkey": {"#pubkey"},
"amount": "1000000000000000000axrp",
"moniker": "STAVR_guide",
"identity": "",
"website": "",
"security": "",
"details": "",
"commission-rate": "0.05",
"commission-max-rate": "0.2",
"commission-max-change-rate": "0.2",
"min-self-delegation": "1"
}
exrpd --home $HOME/.exrpd tx staking create-validator $HOME/.exrpd/validator.json --from WalletName --chain-id xrplevm_144000-1 -yMonitoring
You can set up your node status alarm here - Monitoring
Security
You can create secure management of your wallet and your node by following this links.
Delete node
sudo systemctl stop exrpd
sudo systemctl disable exrpd
rm /etc/systemd/system/exrpd.service
sudo systemctl daemon-reload
cd $HOME
rm -rf exrpd
rm -rf .exrpd
rm -rf $(which exrpd)Last updated
Was this helpful?