logo
Contact UsStake
X PrimeFlow

Manual node installation

Official operator documentationProject websiteSource repositoryExplorer

Network: Testnet

Chain ID: sunima_8081-2

Guide review: 2026-07-14 ยท 4 source references

Recommended hardware: 16 CPU, 32GB RAM and 1TB NVMe minimum for a validator; 24+ CPU, 64GB RAM and 2TB NVMe recommended

Binary: sunimad

Node home: ~/.sunima

1. Prepare the node host

sudo apt-get update
sudo apt-get install -y ca-certificates curl jq tar

# This guide installs a checksum-verified official binary artifact.
# A Go toolchain is not required for the pinned binary path.

2. Install the checksum-verified node binary

set -euo pipefail
ARTIFACT_URL="https://sunima.uk/chain/sunimad-linux-amd64"
ARTIFACT_FILE=$(mktemp)
trap 'rm -f "$ARTIFACT_FILE"' EXIT

curl --fail --show-error --location --proto "=https" --max-time 300 \
  --output "$ARTIFACT_FILE" "$ARTIFACT_URL"
printf '%s  %s\n' 'a8503346a5b845b4b0a2a41ef4c2fef331faf67448f0cc2b65e67e653bbfc26c' "$ARTIFACT_FILE" | sha256sum --check -
sudo install -m 0755 "$ARTIFACT_FILE" /usr/local/bin/sunimad
/usr/local/bin/sunimad version --long

# Verify which binary will be used before initialization.
command -v "sunimad"
"sunimad" version

3. Initialize a new node home

set -euo pipefail
BIN="sunimad"
CHAIN_ID="sunima_8081-2"
MONIKER='validator-name'
NODE_HOME="$HOME/.sunima"

command -v "$BIN"
test ! -e "$NODE_HOME" || { echo "Stop: $NODE_HOME already exists; back it up and review it first." >&2; exit 1; }
"$BIN" init "$MONIKER" --chain-id "$CHAIN_ID" --home "$NODE_HOME"
test -f "$NODE_HOME/config/genesis.json"

4. Install and validate genesis

set -euo pipefail
CHAIN_ID="sunima_8081-2"
NODE_HOME="$HOME/.sunima"
GENESIS_URL='https://sunima.uk/chain/genesis.json'
GENESIS_DOWNLOAD="$NODE_HOME/config/genesis.json.download"

test -d "$NODE_HOME/config"
test ! -e "$GENESIS_DOWNLOAD" || { echo "Stop: review the existing $GENESIS_DOWNLOAD first." >&2; exit 1; }
curl --fail --show-error --location --proto "=https" --max-time 120   --output "$GENESIS_DOWNLOAD" "$GENESIS_URL"
jq -e --arg chain "$CHAIN_ID" '.chain_id == $chain' "$GENESIS_DOWNLOAD" >/dev/null
printf '%s  %s
' '32a5d0c4e260277e619b2585f9ed13437b7aff0a743b684b071a0cc8b2dada41' "$GENESIS_DOWNLOAD" | sha256sum --check -
cp --no-clobber "$NODE_HOME/config/genesis.json" "$NODE_HOME/config/genesis.json.init-backup" || true
install -m 0644 "$GENESIS_DOWNLOAD" "$NODE_HOME/config/genesis.json"
jq -r '.chain_id' "$NODE_HOME/config/genesis.json"

5. Configure minimum gas prices

set -euo pipefail
APP_TOML="$HOME/.sunima/config/app.toml"
test -f "$APP_TOML"
cp --no-clobber "$APP_TOML" "$APP_TOML.bonynode-backup" || true

if grep -q '^minimum-gas-prices' "$APP_TOML"; then
  sed -i 's|^minimum-gas-prices *=.*|minimum-gas-prices = "1000000000asuna"|' "$APP_TOML"
else
  printf '
minimum-gas-prices = "1000000000asuna"
' >> "$APP_TOML"
fi
grep '^minimum-gas-prices' "$APP_TOML"

6. Configure reviewed persistent peers

set -euo pipefail
CONFIG_TOML="$HOME/.sunima/config/config.toml"
PERSISTENT_PEERS='[email protected]:26656'
test -f "$CONFIG_TOML"
cp --no-clobber "$CONFIG_TOML" "$CONFIG_TOML.bonynode-backup" || true
sed -i "s|^persistent_peers *=.*|persistent_peers = "$PERSISTENT_PEERS"|" "$CONFIG_TOML"
grep '^persistent_peers' "$CONFIG_TOML"

7. Create the service, start and verify the node

set -euo pipefail
BIN="sunimad"
CHAIN_ID="sunima_8081-2"
NODE_HOME="$HOME/.sunima"
SERVICE="sunimad.service"
BIN_PATH=$(command -v "$BIN")
SERVICE_USER="$USER"

test -x "$BIN_PATH"
test -s "$NODE_HOME/config/genesis.json"
sudo tee "/etc/systemd/system/$SERVICE" >/dev/null <<EOF
[Unit]
Description=Sunima node
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=${SERVICE_USER}
ExecStart=${BIN_PATH} start --home ${NODE_HOME}
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now "$SERVICE"
sudo systemctl status "$SERVICE" --no-pager

# Wait briefly for the local RPC listener and require the configured chain ID.
for attempt in {1..30}; do
  if STATUS=$(curl --fail --silent http://127.0.0.1:26657/status); then
    jq -e --arg chain "$CHAIN_ID" '.result.node_info.network == $chain' <<<"$STATUS"
    exit 0
  fi
  sleep 2
done
echo 'Local RPC did not become ready; inspect the service journal.' >&2
sudo journalctl -u "$SERVICE" -n 100 --no-pager
exit 1