Skip to main content

Join Lava Testnet

1. Setup working environment​

  1. Verify hardware requirements are met.

  2. Update the system and install dependencies:

    note

    You may need to run as sudo

    • Install required packages

      ### Packages installations

      sudo apt update 
      sudo apt install -y unzip logrotate git jq lz4 sed wget curl coreutils  make gcc 
      sudo apt -qy upgrade

    • Install Go:

      ### Configurations
      go_package_url="https://go.dev/dl/go1.23.3.linux-amd64.tar.gz"
      go_package_file_name=${go_package_url##*\/}

      # Download Go
      wget -q $go_package_url
      # Unpack the Go installation file
      sudo tar -C /usr/local -xzf $go_package_file_name

      # Environment adjustments
      echo "export PATH=\$PATH:/usr/local/go/bin" >>~/.profile
      echo "export PATH=\$PATH:\$(go env GOPATH)/bin" >>~/.profile
      source ~/.profile

    • Verify installation:

      1. You can verify the installed go version by running:

        go version

      2. Verify that GOPATH includes $HOME/go:

        go env GOPATH

        If $HOME/go isn't included, add it by running:

        export GOPATH=$HOME/go

      3. Verify that your PATH include $HOME/go/bin:

        echo $PATH

2. Set your moniker​

Set your moniker name. You can change your moniker in the future.

MONIKER="YOUR_MONIKER_NAME"

3. Install Lava binaries​

To run the Lava mainnet node, you will need a lavad binary installed on your machinne:

#Download lavad
cd $HOME
git clone https://github.com/lavanet/lava.git
cd lava
git checkout v5.2.0


# Build binaries
export LAVA_BINARY=lavad
make build


# Prepare binaries for Cosmovisor
mkdir -p $HOME/.lava/cosmovisor/genesis/bin
mv build/lavad $HOME/.lava/cosmovisor/genesis/bin/
rm -rf build


# Create application symlinks
ln -s $HOME/.lava/cosmovisor/genesis $HOME/.lava/cosmovisor/current -f
sudo ln -s $HOME/.lava/cosmovisor/current/bin/lavad /usr/local/bin/lavad -f

4. Set up Cosmovisor service​

Install cosmovisor to ensure any future upgrades happen flawlessly. To install Cosmovisor:

go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]

Create the service

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

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.lava"
Environment="DAEMON_NAME=lavad"
Environment="UNSAFE_SKIP_BACKUP=true"

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable lava.service

5. Initialize the chain​

Initialize the chain setup:​

lavad init $MONIKER --chain-id lava-testnet-2

Download genesis and addrbook​

curl -Ls https://snapshots.kjnodes.com/lava-testnet/genesis.json > $HOME/.lava/config/genesis.json
curl -Ls https://snapshots.kjnodes.com/lava-testnet/addrbook.json > $HOME/.lava/config/addrbook.json

Configure external seeds​

sed -i -e "s|^seeds *=.*|seeds = \"3f472746f46493309650e5a033076689996c8881@lava-testnet.rpc.kjnodes.com:14459\"|" $HOME/.lava/config/config.toml

Set minimum gas price​

sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0ulava\"|" $HOME/.lava/config/app.toml

Set pruning​

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

Update chain specific configuration​

sed -i \
  -e 's/timeout_commit = ".*"/timeout_commit = "30s"/g' \
  -e 's/timeout_propose = ".*"/timeout_propose = "1s"/g' \
  -e 's/timeout_precommit = ".*"/timeout_precommit = "1s"/g' \
  -e 's/timeout_precommit_delta = ".*"/timeout_precommit_delta = "500ms"/g' \
  -e 's/timeout_prevote = ".*"/timeout_prevote = "1s"/g' \
  -e 's/timeout_prevote_delta = ".*"/timeout_prevote_delta = "500ms"/g' \
  -e 's/timeout_propose_delta = ".*"/timeout_propose_delta = "500ms"/g' \
  -e 's/skip_timeout_commit = ".*"/skip_timeout_commit = false/g' \
  $HOME/.lava/config/config.toml
note

At any moment you can edit the values in the configuration files by navigatin to $HOME/.lava/config/app.toml and $HOME/.lava/config/config.toml.

6. Download the latest snapshot​

curl -L https://snapshots.kjnodes.com/lava-testnet/snapshot_latest.tar.lz4 | tar -Ilz4 -xf - -C $HOME/.lava
[[ -f $HOME/.lava/data/upgrade-info.json ]] && cp $HOME/.lava/data/upgrade-info.json $HOME/.lava/cosmovisor/genesis/upgrade-info.json

7. Start the service and check the logs​

sudo systemctl start lava-testnet.service && sudo journalctl -u lava-testnet.service -f --no-hostname -o cat

8. Verify​

Verify service setup​

Make sure cosmovisor is running by checking the state of the service:

Check the status of the service

sudo systemctl status lava.testnet

To view the service logs - to escape, hit CTRL+C

sudo journalctl -u lava.testnet -f

Verify node status​

Note the location of lavad now exists under cosmovisor path:

# Check if the node is currently in the process of catching up
lavad status | jq .SyncInfo.catching_up

Welcome to Lava Mainnet 🌋​

Joined Mainnet? Be a validator!

You are now running a Node in the Lava network 🎉🥳!

When you're ready, start putting the node to use as a validator:

🧑‍⚖️
Power as a Validator
Validate blocks, secure the network, earn rewards