Cosmos Hub

For Ubuntu 22.04 or later. The node listens on ports starting with your port prefix (e.g. 26657 becomes 19657), so several nodes can share a server.

1. 01Install tools

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y curl git wget jq make gcc build-essential lz4 zstd tmux htop unzip

   Copy

2. 02Install Go

   cd $HOME
   VER="<go-version>"
   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 $HOME/.bash_profile ] && touch $HOME/.bash_profile
   echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> $HOME/.bash_profile
   source $HOME/.bash_profile
   mkdir -p $HOME/go/bin
   go version

   Copy

3. 03Build the binary

   cd $HOME
   rm -rf gaia
   git clone https://github.com/cosmos/gaia.git gaia
   cd gaia
   git checkout <version>
   make install
   gaiad version --long | grep -E '^(version|commit):'

   Copy

4. 04Install Cosmovisor

   go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest
   DAEMON_HOME=$HOME/.gaia DAEMON_NAME=gaiad cosmovisor init $HOME/go/bin/gaiad

   Copy

5. 05Create the service

   sudo tee /etc/systemd/system/gaiad.service > /dev/null << EOF
   [Unit]
   Description=Cosmos Hub node
   After=network-online.target
   
   [Service]
   User=$USER
   ExecStart=$(which cosmovisor) run start
   WorkingDirectory=$HOME/.gaia
   Restart=on-failure
   RestartSec=10
   LimitNOFILE=65535
   Environment="DAEMON_HOME=$HOME/.gaia"
   Environment="DAEMON_NAME=gaiad"
   Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"
   Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
   Environment="UNSAFE_SKIP_BACKUP=true"
   Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:$HOME/.gaia/cosmovisor/current/bin"
   
   [Install]
   WantedBy=multi-user.target
   EOF
   sudo systemctl daemon-reload
   sudo systemctl enable gaiad

   Copy

6. 06Set variables

   echo 'export WALLET="wallet"' >> $HOME/.bash_profile
   echo 'export MONIKER="Your-Moniker"' >> $HOME/.bash_profile
   echo 'export GAIA_CHAIN_ID="<chain-id>"' >> $HOME/.bash_profile
   echo 'export GAIA_PORT="19"' >> $HOME/.bash_profile
   source $HOME/.bash_profile

   Copy

7. 07Initialize the node

   gaiad init "$MONIKER" --chain-id $GAIA_CHAIN_ID --home $HOME/.gaia
   gaiad config set client chain-id $GAIA_CHAIN_ID
   gaiad config set client keyring-backend os
   gaiad config set client node tcp://localhost:$GAIA_PORT657

   Copy

8. 08Custom ports

   sed -i.bak -e "s%:1317%:$GAIA_PORT317%g;
   s%:8080%:$GAIA_PORT080%g;
   s%:9090%:$GAIA_PORT090%g;
   s%:9091%:$GAIA_PORT091%g;
   s%:8545%:$GAIA_PORT545%g;
   s%:8546%:$GAIA_PORT546%g" $HOME/.gaia/config/app.toml
   sed -i.bak -e "s%:26658%:$GAIA_PORT658%g;
   s%:26657%:$GAIA_PORT657%g;
   s%:6060%:$GAIA_PORT060%g;
   s%:26656%:$GAIA_PORT656%g;
   s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):$GAIA_PORT656\"%;
   s%:26660%:$GAIA_PORT660%g" $HOME/.gaia/config/config.toml

   Copy

9. 09Minimum gas price

   sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.005uatom\"|" $HOME/.gaia/config/app.toml

   Copy

10. 10Pruning

    sed -i -e "s/^pruning *=.*/pruning = \"custom\"/" $HOME/.gaia/config/app.toml
    sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" $HOME/.gaia/config/app.toml
    sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"19\"/" $HOME/.gaia/config/app.toml

    Copy

11. 11Disable the indexer

    sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.gaia/config/config.toml

    Copy

12. 12Start the node

    sudo systemctl restart gaiad && sudo journalctl -fu gaiad -o cat

    Copy

13. 13Check sync

    curl -s localhost:$GAIA_PORT657/status | jq .result.sync_info

    Copy