Bitcanna Node Installation Guide

Chain ID: bitcanna-1

Install Go and Cosmovisor

Feel free to skip this step if you already have Go and Cosmovisor.

Install Go

We will use Go v1.21.1 as example here. The code below also cleanly removes any previous Go installation.

sudo rm -rvf /usr/local/go/
wget https://golang.org/dl/go1.21.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.1.linux-amd64.tar.gz
rm go1.21.1.linux-amd64.tar.gz

Configure Go

Unless you want to configure in a non-standard way, then set these in the ~/.profile file.

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin

Install Cosmovisor

We will use Cosmovisor v1.0.0 as example here.

go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/[email protected]

Install Node

Install the current version of node binary.

git clone https://github.com/BitCannaGlobal/bcna bitcanna
cd bitcanna
git checkout v2.0.3
make install

Configure Node

Initialize Node

Please replace YOUR_MONIKER with your own moniker.

bcnad init YOUR_MONIKER --chain-id bitcanna-1

Download Genesis

The genesis file link below is Polkachu's mirror download. The best practice is to find the official genesis download link.

wget -O genesis.json https://raw.githubusercontent.com/BitCannaGlobal/bcna/main/genesis.json --inet4-only
mv genesis.json ~/.bcna/config

Configure Seed

Using a seed node to bootstrap is the best practice in our view.

sed -i 's/seeds = ""/seeds = "[email protected]:13056"/' ~/.bcna/config/config.toml

Launch Node

Configure Cosmovisor Folder

Create Cosmovisor folders and load the node binary.

# Create Cosmovisor Folders
mkdir -p ~/.bcna/cosmovisor/genesis/bin
mkdir -p ~/.bcna/cosmovisor/upgrades

# Load Node Binary into Cosmovisor Folder
cp ~/go/bin/bcnad ~/.bcna/cosmovisor/genesis/bin

Create Service File

Create a bitcanna.service file in the /etc/systemd/system folder with the following code snippet. Make sure to replace USER with your Linux user name. You need sudo previlege to do this step.

[Unit]
Description="bitcanna node"
After=network-online.target

[Service]
User=USER
ExecStart=/home/USER/go/bin/cosmovisor start
Restart=always
RestartSec=3
LimitNOFILE=4096
Environment="DAEMON_NAME=bcnad"
Environment="DAEMON_HOME=/home/USER/.bcna"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="UNSAFE_SKIP_BACKUP=true"

[Install]
WantedBy=multi-user.target

Start Node Service

# Enable service
sudo systemctl enable bitcanna.service

# Start service
sudo service bitcanna start

# Check logs
sudo journalctl -fu bitcanna