Skip to main content
Side Installation Guide

Side Installation Guide

Chain ID:

auto

Current Node Version:

auto

Install dependencies​

sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential
sudo apt -qy upgrade

Install GO​

ver="1.21.3" &&
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 with Cosmovisor​

ADVANCED ROUTE

Cosmosvisor is a process manager for Cosmos SDK application binaries that monitors the governance module for incoming chain upgrade proposals. If a proposal is approved, cosmosvisor can automatically download the new binary, stop the current one, switch to the new binary, and restart the node with the new binary.

Download and build binaries​

Clone Side repo and build sided auto​

cd $HOME
git clone https://github.com/sideprotocol.git
cd sideprotocol
git checkout auto

Build binaries​

make install

Prepare binaries for Cosmovisor​

cd $HOME
mkdir -p ~/.side/cosmovisor/upgrades/auto/bin
mv $HOME/go/bin/sided ~/.side/cosmovisor/upgrades/auto/bin/
sudo ln -s ~/.side/cosmovisor/genesis ~/.side/cosmovisor/current -f
sudo ln -s ~/.side/cosmovisor/current/bin/sided /usr/local/bin/sided -f

Download and install Cosmovisor​

go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.7.1

Run node​

Create service​

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

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=~/.side"
Environment="DAEMON_NAME=sided"
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:~/.side/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF

Install without Cosmovisor​

Download and build binaries​

Clone Side repo and build sided auto​

cd $HOME
git clone https://github.com/sideprotocol.git
cd sideprotocol
git checkout auto

Build binaries​

make install

Run node​

Create service​

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

[Service]
User=$USER
ExecStart=$(which sided) start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin"

[Install]
WantedBy=multi-user.target
EOF

Enable service​

sudo systemctl daemon-reload
sudo systemctl enable sided

Node configuration​

Set config​

sided config chain-id auto
sided config keyring-backend os
sided config node tcp://localhost:26657

Initialize the node​

sided init NAME_OF_YOUR_VALIDATOR --chain-id auto

Download genesis and addrbook​

curl https://snapshots.noders.services/side/genesis.json -o ~/.side/config/genesis.json
curl https://snapshots.noders.services/side/addrbook.json -o ~/.side/config/addrbook.json

Add peers​

sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"auto\"/" ~/.side/config/config.toml

Set minimum gas price​

sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.001uside\"|" ~/.side/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"|' \
  ~/.side/config/app.toml

Set custom ports​

echo "export SIDED_PORT="SET_YOUR_PORT"" >> $HOME/.bash_profile
# Set custom ports in app.tom{l
sed -i.bak -e "s%:1317%:${SIDED_PORT}317%g" \
-e "s%:8080%:${SIDED_PORT}080%g" \
-e "s%:9090%:${SIDED_PORT}090%g" \
-e "s%:9091%:${SIDED_PORT}091%g" \
-e "s%:8545%:${SIDED_PORT}545%g" \
-e "s%:8546%:${SIDED_PORT}546%g" \
-e "s%:6065%:${SIDED_PORT}065%g" ~/.side/config/app.toml

# Set custom ports in config.toml file
sed -i.bak -e "s%:26658%:${SIDED_PORT}658%g" \
-e "s%:26657%:${SIDED_PORT}657%g" \
-e "s%:6060%:${SIDED_PORT}060%g" \
-e "s%:26656%:${SIDED_PORT}656%g" \
-e "s%:26660%:${SIDED_PORT}660%g" ~/.side/config/config.toml