AtomOne Testnet Node Installation Guide (atomone-testnet-1)

📋 Hardware Requirements

Component	Minimum	Recommended
CPU	4 Cores	8 Cores
RAM	8 GB	16 GB
SSD	200 GB NVMe	500 GB NVMe
OS	Ubuntu 22.04	Ubuntu 22.04

🛠 Installation Steps

1. System Update & 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.21.13"
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. Configure Environment Variables

echo "export WALLET="wallet"" >> $HOME/.bash_profile
echo "export MONIKER="test"" >> $HOME/.bash_profile
echo "export ATOMONE_CHAIN_ID="atomone-testnet-1"" >> $HOME/.bash_profile
echo "export ATOMONE_PORT="62"" >> $HOME/.bash_profile
source $HOME/.bash_profile

4. Install Binary & Cosmovisor

We utilize Cosmovisor to manage binary upgrades automatically.

# Install Cosmovisor
go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@latest

# Clone and build binary
cd $HOME
rm -rf atomone
git clone https://github.com/atomone-hub/atomone
cd atomone
git checkout v3.3.0
make install

# Prepare Cosmovisor structure
mkdir -p $HOME/.atomone/cosmovisor/genesis/bin
mkdir -p $HOME/.atomone/cosmovisor/upgrades
cp $(which atomoned) $HOME/.atomone/cosmovisor/genesis/bin/

5. Node Configuration & Initialization

atomoned config node tcp://localhost:${ATOMONE_PORT}657
atomoned config keyring-backend os
atomoned config chain-id atomone-testnet-1
atomoned init $MONIKER --chain-id atomone-testnet-1

# Download Genesis and Addrbook
wget -O $HOME/.atomone/config/genesis.json https://server-4.itrocket.net/testnet/atomone/genesis.json
wget -O $HOME/.atomone/config/addrbook.json  https://server-4.itrocket.net/testnet/atomone/addrbook.json

# Set Seeds and Peers
SEEDS="85e441cfe74b8c0f8b820beff46edab20e92716c@atomone-testnet-seed.itrocket.net:62657"
PEERS="bddf062a8328bcc50e37f83448e770e2e385c72f@atomone-testnet-peer.itrocket.net:62656,[email protected]:26656,[email protected]:62656,2516ab05cbaade0a9a3c506f0f13962fea64edc1@[2a01:4f9:1a:9462::10]:26656"
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" $HOME/.atomone/config/config.toml

# Customize Ports
sed -i.bak -e "s%:1317%:${ATOMONE_PORT}317%g; s%:8080%:${ATOMONE_PORT}080%g; s%:9090%:${ATOMONE_PORT}090%g; s%:9091%:${ATOMONE_PORT}091%g; s%:8545%:${ATOMONE_PORT}545%g; s%:8546%:${ATOMONE_PORT}546%g; s%:6065%:${ATOMONE_PORT}065%g" $HOME/.atomone/config/app.toml
sed -i.bak -e "s%:26658%:${ATOMONE_PORT}658%g; s%:26657%:${ATOMONE_PORT}657%g; s%:6060%:${ATOMONE_PORT}060%g; s%:26656%:${ATOMONE_PORT}656%g; s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${ATOMONE_PORT}656\"%; s%:26660%:${ATOMONE_PORT}660%g" $HOME/.atomone/config/config.toml

# Pruning & Indexer Settings
sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.atomone/config/app.toml 
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.atomone/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.atomone/config/app.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.atomone/config/config.toml
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.001uatone"|g' $HOME/.atomone/config/app.toml
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.atomone/config/config.toml

6. Create Systemd Service (Using Cosmovisor)

sudo tee /etc/systemd/system/atomoned.service > /dev/null <<EOF
[Unit]
Description=Atomone Node (Cosmovisor)
After=network-online.target

[Service]
User=$USER
WorkingDirectory=$HOME/.atomone
ExecStart=$(which cosmovisor) run start --home $HOME/.atomone
Restart=on-failure
RestartSec=5
LimitNOFILE=65535
Environment="DAEMON_NAME=atomoned"
Environment="DAEMON_HOME=$HOME/.atomone"
Environment="DAEMON_ALLOW_STRUCTURAL_ADDITIONS=true"
Environment="UNSAFE_SKIP_BACKUP=true"

[Install]
WantedBy=multi-user.target
EOF

7. Snapshot & Start Node

atomoned tendermint unsafe-reset-all --home $HOME/.atomone
curl https://server-4.itrocket.net/testnet/atomone/atomone_2026-04-15_6652909_snap.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.atomone

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

---

🔑 Wallet & Validator Setup

Wallet Operations

atomoned keys add $WALLET
# OR restore existing wallet
atomoned keys add $WALLET --recover

Create Validator

Check synchronization status (wait for false):

atomoned status 2>&1 | jq .SyncInfo.catching_up

Create the validator:

atomoned tx staking create-validator \
--amount 1000000uphoton \
--from $WALLET \
--commission-rate 0.1 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.01 \
--min-self-delegation 1 \
--pubkey $(atomoned tendermint show-validator) \
--moniker $MONIKER \
--chain-id atomone-testnet-1 \
--gas auto --gas-adjustment 1.5 --fees 500uphoton \
-y

---

🗑 Uninstall Node

sudo systemctl stop atomoned
sudo systemctl disable atomoned
sudo rm -rf /etc/systemd/system/atomoned.service
sudo rm $(which atomoned)
sudo rm -rf $HOME/.atomone
sed -i "/ATOMONE_/d" $HOME/.bash_profile