October 21

Stargaze node installation

Prerequisites

1. System Requirements:

  • CPU: 8 cores
  • RAM: 16 GB
  • Storage: 1 TB SSD (NVMe recommended)
  • OS: Ubuntu 20.04 or similar Linux distribution

2. Install Dependencies:

Ensure the following are installed:

bashSkopiuj kodsudo apt update
sudo apt install -y build-essential git wget curl jq

Install Go (required version >=1.18):

bashSkopiuj kodwget https://golang.org/dl/go1.18.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.18.1.linux-amd64.tar.gz
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> ~/.profile
source ~/.profile

3. Clone Stargaze Repository & Install Binary:

bashSkopiuj kodgit clone https://github.com/public-awesome/stars
cd stars
git checkout v1.1.0
make install

Verify the installation:

bashSkopiuj kodstarsd version

4. Configure Node:

Initialize the Node:

bashSkopiuj kodstarsd init <your-moniker> --chain-id stargaze-1

Download the genesis file:

bashSkopiuj kodcurl -s https://raw.githubusercontent.com/public-awesome/mainnet/main/stargaze-1/genesis.tar.gz | tar -xzf - -C ~/.starsd/config/

Set Persistent Peers (Optional):

Retrieve peers for your node to connect with the network:

bashSkopiuj kodexport CHAIN_REPO="https://raw.githubusercontent.com/public-awesome/mainnet/main/stargaze-1"
export PEERS="$(curl -s "$CHAIN_REPO/peers.txt")"

Add the peers to your config file:

bashSkopiuj kodsed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" ~/.starsd/config/config.toml

Configure Gas Prices:

bashSkopiuj kodsed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"1ustars\"/" ~/.starsd/config/app.toml

5. Set Up Cosmovisor:

To handle automated upgrades, install Cosmovisor:

bashSkopiuj kodgo install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@latest

Set environment variables:

bashSkopiuj kodecho "export DAEMON_NAME=starsd" >> ~/.profile
echo "export DAEMON_HOME=$HOME/.starsd" >> ~/.profile
source ~/.profile

Create the folder structure for Cosmovisor:

bashSkopiuj kodmkdir -p $DAEMON_HOME/cosmovisor/genesis/bin
cp $(which starsd) $DAEMON_HOME/cosmovisor/genesis/bin/

6. Start the Node:

Synchronize with the Network:

Start your node and allow it to sync with the blockchain:

bashSkopiuj kodstarsd start

You can monitor the logs to track progress:

bashSkopiuj kodtail -f ~/.starsd/logs/starsd.log

7. Set Up Validator:

After the node is fully synced, create or restore a wallet:

bashSkopiuj kodstarsd keys add <your-wallet-name>

Submit a transaction to create your validator:

bashSkopiuj kodstarsd tx staking create-validator \
  --amount=1000000ustars \
  --pubkey=$(starsd tendermint show-validator) \
  --moniker="<your-moniker>" \
  --chain-id=stargaze-1 \
  --commission-rate="0.10" \
  --commission-max-rate="0.20" \
  --commission-max-change-rate="0.01" \
  --min-self-delegation="1" \
  --from=<your-wallet-name> \
  --gas="auto" --fees=500ustars

8. Optional: Set Up StateSync:

To speed up syncing, you can use StateSync. Stargaze provides this feature, and you can configure it following these instructions.

By following these steps, your Stargaze validator node should be fully operational. For further details, you can visit Stargaze's official documentation.