Installation - Krews Docs

This guide follows the official Sunrise documentation. Use mainnet values unless you intentionally target the testnet.

Quick facts

Binary: sunrised
Chain ID (mainnet): sunrise-1
Go toolchain: 1.24.2 (min per docs)
Recommended min gas price: 0.025uusdrise (protects from spam)
Mainnet genesis: https://raw.githubusercontent.com/sunriselayer/network/main/sunrise-1/genesis.json

Install & initialize

Install dependencies and Go

Ubuntu 22.04 LTS is used in the official guide.

# Install Go 1.24.x (example using tarball; or use your package manager)
wget https://go.dev/dl/go1.24.2.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.24.2.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' | tee -a ~/.profile
source ~/.profile
go version

Build the sunrise binary

git clone https://github.com/sunriselayer/sunrise.git
cd sunrise
git checkout <TAG>   # Use the binary version appropriate for your sync height
make install         # installs sunrised in $GOBIN
sunrised version

Initialize node

export CHAIN_ID=sunrise-1
export MONIKER="my-node"
sunrised init "$MONIKER" --chain-id $CHAIN_ID

Fetch genesis (mainnet)

rm -f $HOME/.sunrise/config/genesis.json
curl -L https://raw.githubusercontent.com/sunriselayer/network/main/sunrise-1/genesis.json -o $HOME/.sunrise/config/genesis.json

Set minimum gas prices

sed -i.bak -e 's/^minimum-gas-prices *=.*/minimum-gas-prices = "0.025uusdrise"/' $HOME/.sunrise/config/app.toml

(Optional) Seeds & persistent peers

Seeds and peers are published in the network repo. Example (mainnet seeds):

SEEDS=$(curl -sL https://raw.githubusercontent.com/sunriselayer/network/main/sunrise-1/seeds.txt | tr '\n' ',')
sed -i.bak -e "s/^seeds *=.*/seeds = \"$SEEDS\"/" $HOME/.sunrise/config/config.toml

You can also populate persistent_peers similarly.

(Optional) Storage & indexing

If connecting to a bridge node or running an archive, enable tx indexing and retain all block data:

# config.toml
indexer = "kv"

# app.toml
min-retain-blocks = 0

Start the node

With Cosmovisor (recommended for upgrades): follow the official Cosmovisor setup, then start.
Without Cosmovisor:

sunrised start

Verify sync

curl -s localhost:26657/status | jq .result.sync_info.catching_up

Mainnet endpoints and the latest release tags are listed under Run a Sunrise Node → Networks → Mainnet. Snapshots are often provided by third parties (e.g., Polkachu). Validate source and height before use.

​Quick facts

​Install & initialize

​Verify sync

Quick facts

Install & initialize

Verify sync