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
- Install Dependencies
bash
sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc unzip -y
- Install Go
bash
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
- Set Vars
Configuration:
Generated Code:
Loading...
- Download Binary
bash
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
- Initialize
bash
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
- Download genesis
bash
wget https://raw.githubusercontent.com/xos-labs/networks/refs/heads/main/testnet/genesis.json -O ~/.xosd/config/genesis.json
- Configure Node
Configure peers
bash
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
bash
curl -L -o $HOME/.xosd/config/addrbook.json https://vault.astrostake.xyz/testnet/xos/addrbook.json
Update app.toml
ports
bash
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
bash
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
bash
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
bash
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
- Create Service
bash
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
- Start Service
bash
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
bash
sudo journalctl -u xosd -fo cat
Check Sync
bash
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:
bash
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.