⚒️Installation

Stargaze Mainnet guide

Hardware Requirements

Node Type

CPU

RAM

Storage

Validator

16GB

1TB* (SSD or NVME)

Full Node

8GB

1TB

Server preparation

Update your system packages:

sudo apt update && sudo apt upgrade -y

Install essential dependencies:

sudo apt-get install -y make git-core libssl-dev pkg-config libclang-12-dev build-essential protobuf-compiler

Install Go 1.23.1 (required for building Stargaze):

ver="1.23.1"
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"
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
go version

Install Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env

Install CometBFT:

cd $HOME
rm -rf cometbft
git clone https://github.com/cometbft/cometbft.git
cd cometbft
git checkout v0.37.15
make build
sudo cp $HOME/cometbft/build/cometbft /usr/local/bin/
cometbft version

Set custom configs server

export NAMADA_NETWORK_CONFIGS_SERVER="https://github.com/anoma/namada-mainnet-genesis/releases/download/mainnet-genesis"

Download and Install Namada Binaries

Clone the Namada repository and download the binary:

cd $HOME
git clone https://github.com/anoma/namada
cd namada
wget https://github.com/anoma/namada/releases/download/v1.1.5/namada-v1.1.5-Linux-x86_64.tar.gz
tar -xvf namada-v1.1.5-Linux-x86_64.tar.gz
rm namada-v1.1.5-Linux-x86_64.tar.gz
sudo mv namada-v1.1.5-Linux-x86_64/namad* /usr/local/bin/
mkdir -p $HOME/.namada

💡 mkdir -p ensures the .namada directory is created only if it doesn't already exist.

Verify the installation:

namada --version

Expected output:
Namada v1.1.5

Join-network

namadac utils join-network --chain-id namada.5f5de2dd1b88cba30586420
sed -i 's#persistent_peers = ".*"#persistent_peers = "tcp://[email protected]:26656,tcp://[email protected]:46656"#' $HOME/.local/share/namada/namada.5f5de2dd1b88cba30586420/config.toml

cd $HOME 
cp -r ~/.namada/pre-genesis $HOME/.local/share/namada
namada client utils join-network --chain-id namada.5f5de2dd1b88cba30586420 --genesis-validator <ALIAS>
sed -i 's#persistent_peers = ".*"#persistent_peers = "tcp://[email protected]:26656,tcp://[email protected]:46656"#' $HOME/.local/share/namada/namada.5f5de2dd1b88cba30586420/config.toml

Setup Peers

sed -i 's#persistent_peers = ".*"#persistent_peers = "tcp://[email protected]:26656,tcp://[email protected]:46656"#' $HOME/.local/share/namada/namada.5f5de2dd1b88cba30586420/config.toml

Create a Systemd Service File

Create and configure the systemd service to run Stargaze as a service:

sudo tee /etc/systemd/system/namadad.service > /dev/null <<EOF
[Unit]
Description=namada
After=network-online.target

[Service]
User=$USER
WorkingDirectory=$BASE_DIR
Environment=CMT_LOG_LEVEL=p2p:none,pex:error
Environment=NAMADA_CMT_STDOUT=true
ExecStart=$(which namada) node ledger run
StandardOutput=syslog
StandardError=syslog
Restart=always
RestartSec=10
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Reload and start the Stargaze service:

sudo systemctl daemon-reload
sudo systemctl enable namadad
sudo systemctl restart namadad && sudo journalctl -u namadad -f

Check Node Sync Status

curl http://127.0.0.1:26657/status | jq

Look for this line in the output:

"catching_up": false

This means your node is fully synced.

Manage YourWwallet

Create a New Wallet

Creates a new transparent or shielded secret key and saves it under the provided alias.

namadaw gen --alias <WALLET_NAME>

Restore an Existing Wallet

Restores a transparent or shielded key from a mnemonic phrase or a hardware device.

namadaw derive --alias <WALLET_NAME>

Find Your Wallet Address

namadaw find --alias <WALLET_NAME>

Look for the implicit address starting with tnam... — you’ll need it.

Check Wallet Balance

Displays the current balance of your wallet.

namadac balance --owner <WALLET_NAME> --token nam

List Wallet Keys

Lists all known keys and addresses in your local wallet.

namadaw list

Delete Wallet

namadaw remove --alias <WALLET_NAME> --do-it

This will completely remove the wallet and all its data.

Become a Validator on Namada

This guide walks you through the process of turning your full node into a validator on the Namada network. Make sure your full node is already synced before proceeding.

Prerequisites:

A fully synced Namada full node
Your wallet (established account) already created
Enough tokens in your wallet for self-bonding
CLI tools installed: namadac, namadaw, namadad

Step 1: Initialize the Validator

Run the following command to become a validator:

namadac init-validator \
  --commission-rate 0.07 \
  --max-commission-rate-change 1 \
  --signing-keys <your-wallet-name> \
  --alias <your-validator-alias> \
  --email <[email protected]> \
  --website <https://your-website.com> \
  --discord-handle <your-discord#0000> \
  --account-keys <your-alias> \
  --memo <"Your memo or short description">

Step 2: Get Your Validator Address

Find your establishedvalidator address

namadaw list

Step 3: Restart the Node

Restart your node and follow the logs:

sudo systemctl restart namadad
sudo journalctl -u namadad -f

Step 4: Wait for 2 Epochs

Check the current epoch:

namada client epoch

Once 2 epochs have passed, proceed to bond your stake.

Step 5: Bond Stake to Your Validator

namadac bond \
  --validator <your-validator-address> \
  --source <your-wallet-name> \
  --amount 1000 \
  --memo <"Your memo or short description">

Step 6: Check Validator Status

After 3 epochs, verify that your validator is in the consensus set:

namadac validator-state --validator <your-validator-address>

You can also check your bond status:

namada client bonds --owner <your-wallet-name>

Optional: Add More Stake

To increase your stake later:

namadac bond \
  --source <your-wallet-name> \
  --validator <your-validator-address> \
  --amount 1000

Query Useful Info

Validator info:

namada client validator-state --validator <your-validator-address>

All bonded stakes:

namadac bonded-stake

Unbond & Withdraw Tokens

Unbond tokens:

namadac unbond \
  --source <your-wallet-name> \
  --validator <your-validator-address> \
  --amount 1000

Check unbond status (wait 6 epochs):

namadac bonds --owner <your-wallet-name>

Withdraw unbonded tokens:

namadac withdraw \
  --source <your-wallet-name> \
  --validator <your-validator-address>

You're Done!

You are now a validator on Namada. Don't forget to:

Monitor your validator performance
Claim rewards regularly
Update your metadata as needed
Engage in governance voting

Delete node

sudo systemctl stop namadad
sudo systemctl disable namadad
sudo rm -rf /etc/systemd/system/namadad.service
sudo systemctl daemon-reload
sudo rm $(which namada)
sudo rm -rf $HOME/.local/share/namada/namada.5f5de2dd1b88cba30586420

PreviousNamada Docs NextServices Snapshot

Last updated 2 months ago