XOS Labs

XOS is a high-performance, low-cost chain that natively bridges major assets such as SPL and ERC20.

Recommended Hardware:

• 6 Cores
• 16GB RAM
• 4TB of storage (NVME)

Chaind ID	Last Version Tag
xos_1267-1	v0.5.2

Service	URL
RPC	https://xos-testnet-rpc.astrostake.xyz
API	https://xos-testnet-api.astrostake.xyz
Resource	https://vault.astrostake.xyz/testnet/xos
Dashboard	https://www.astrostake.xyz/networks/xos

Installation

1. Install Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc unzip -y

2. Install Go

cd $HOME
VER="1.22.3"
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:~/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin

3. Set Vars

Configuration:

Wallet

Moniker

Port

Generated Code:

Loading...

4. Download Binary

wget https://github.com/xos-labs/node/releases/download/v0.5.2/node_0.5.2_Linux_amd64.tar.gz
tar -xzf node_0.5.2_Linux_amd64.tar.gz
sudo mv ./bin/xosd /usr/local/bin/
chmod +x /usr/local/bin/xosd
which xosd

5. Initialize

xosd config node tcp://localhost:${XOSD_PORT}657
xosd config set client keyring-backend os
xosd config chain-id $XOSD_CHAIN_ID
xosd init "Moniker" --chain-id $XOSD_CHAIN_ID

6. Download genesis

wget https://raw.githubusercontent.com/xos-labs/networks/refs/heads/main/testnet/genesis.json -O ~/.xosd/config/genesis.json

7. Configure Node

Configure peers

PEERS=`curl -sL https://raw.githubusercontent.com/xos-labs/networks/main/testnet/peers.txt | sort -R | head -n 10 | awk '{print $1}' | paste -s -d, -`
sed -i.bak -e "s/^seeds *=.*/seeds = \"$PEERS\"/" ~/.xosd/config/config.toml
cat ~/.xosd/config/config.toml | grep seeds

Download addrbook.json

curl -L -o $HOME/.xosd/config/addrbook.json https://vault.astrostake.xyz/testnet/xos/addrbook.json

Update app.toml ports

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

Update config.toml ports

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

Configure pruning

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

Set Minimum Gas Fee & Other Parameters

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

8. Create Service

sudo tee /etc/systemd/system/xosd.service > /dev/null <<EOF
[Unit]
Description=XOS Node
After=network-online.target

[Service]
User=$USER
WorkingDirectory=$HOME/.xosd
ExecStart=$(which xosd) start --home $HOME/.xosd --chain-id xos_1267-1
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

9. Start Service

sudo systemctl daemon-reload
sudo systemctl enable xosd
sudo systemctl restart xosd && sudo journalctl -u xosd -fo cat

Useful Commands

INFO

For a complete guide to creating a validator, visit our Cheat Sheet & Key Management page. It covers all the necessary commands and crucial steps for securing your keys.

Check logs

sudo journalctl -u xosd -fo cat

Check Sync

source <(curl -s https://vault.astrostake.xyz/testnet/xos/sync_check.sh)

🛡️ Security

To apply a quick security baseline, you can configure your firewall like this:

sudo ufw allow ${XOSD_PORT}656/tcp comment 'XOS Node p2p Port'

🔐 For a more secure and maintainable setup, check out our Essentials Guide, including SSH key setup, Fail2Ban protection, and a full VPS hardening checklist.