Manual Installation
Let's explore the manual installation process as we set up a node with Cosmovisor!
Install Dependencies
Update system package and install build tools
sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential fail2ban ufw
sudo apt -qy upgrade
Secure Setup
π’
This step is optional, and you can choose to skip ahead to configure moniker.
Setup ssh for nillion user replace YOUR_PUBLIC_SSH_KEY with your own!
sudo adduser nillion --disabled-password -q
sudo usermod -aG sudo nillion
sudo -u nillion bash -c 'mkdir -p ~/.ssh && echo "YOUR_PUBLIC_SSH_KEY" >> ~/.ssh/authorized_keys && chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys'
Configure Moniker
Replace <your-moniker-name> with your own validator name
MONIKER="<your-moniker-name>"
Install Go
install go version 1.21.3
sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.21.3.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
eval $(echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/golang.sh)
eval $(echo 'export PATH=$PATH:$HOME/go/bin' | tee -a $HOME/.profile)
Build Binaries
Cloning project repository & Compile binaries
cd $HOME
rm -rf nillion
git clone https://github.com/NillionNetwork/nilliond
cd nillion
git checkout v0.2.1
make build
Latest commit : 179cfef832447f2cb681c996cf9e87387f4d4d9f
Prepare binaries for cosmovisor
mkdir -p $HOME/.nillionapp/cosmovisor/genesis/bin
mv build/nilchaind $HOME/.nillionapp/cosmovisor/genesis/bin/
rm -rf build
Create symlinks
sudo ln -s $HOME/.nillionapp/cosmovisor/genesis $HOME/.nillionapp/cosmovisor/current -f
sudo ln -s $HOME/.nillionapp/cosmovisor/current/bin/nilchaind /usr/local/bin/nilchaind -f
Cosmovisor Setup
Install cosmovisor
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.5.0
Create Service
Create a systemd service
sudo tee /etc/systemd/system/nillion.service > /dev/null << EOF
[Unit]
Description=nillion 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/.nillionapp"
Environment="DAEMON_NAME=nilchaind"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:$HOME/.nillionapp/cosmovisor/current/bin"
[Install]
WantedBy=multi-user.target
EOF
Enable Service
Enable nillion systemd service
sudo systemctl daemon-reload
sudo systemctl enable nillion
Initialize Node
Setting node configuration
nilchaind config set client chain-id nillion-chain-testnet-1
nilchaind config set client keyring-backend test
nilchaind config set client node tcp://localhost:24757
Initialize node
nilchaind init $MONIKER --chain-id nillion-chain-testnet-1
Download Genesis & Addrbook
Download genesis & addrbook file
curl -Ls https://snap.nodex.one/nillion-testnet/genesis.json > $HOME/.nillionapp/config/genesis.json
curl -Ls https://snap.nodex.one/nillion-testnet/addrbook.json > $HOME/.nillionapp/config/addrbook.json
sha256sum genesis.json
: 469fc6fbb4d4eed82c82d1671cb156c7fbca703bf58a60c843cfb36f012787b1
Configure Seeds
Setting up a seed peers
sed -i -e "s|^seeds *=.*|seeds = \"d1d43cc7c7aef715957289fd96a114ecaa7ba756@testnet-seeds.nodex.one:24710\"|" $HOME/.nillionapp/config/config.toml
Configure Gas Prices
Setting up a gas prices
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0unil\"|" $HOME/.nillionapp/config/app.toml
Pruning Setting
Configure pruning setting
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/.nillionapp/config/app.toml
Custom Port
Please note that updating the port is optional!
Configure a custom port
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:24758\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:24757\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:24760\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:24756\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":24766\"%" $HOME/.nillionapp/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:24717\"%; s%^address = \":8080\"%address = \":24780\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:24790\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:24791\"%; s%:8545%:24745%; s%:8546%:24746%; s%:6065%:24765%" $HOME/.nillionapp/config/app.toml
Download Snapshots
Download latest chain snapshot
curl -L https://snap.nodex.one/nillion-testnet/nillion-latest.tar.lz4 | tar -Ilz4 -xf - -C $HOME/.nillionapp
[[ -f $HOME/.nillionapp/data/upgrade-info.json ]] && cp $HOME/.nillionapp/data/upgrade-info.json $HOME/.nillionapp/cosmovisor/genesis/upgrade-info.json
Start Service
Letss f*cking goooo!
sudo systemctl start nillion