> For the complete documentation index, see [llms.txt](https://stavr-team.gitbook.io/nodes-guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stavr-team.gitbook.io/nodes-guides/mainnets/bitcanna/node-installation.md).

# Node Installation

## [EXPLORER](https://explorer.stavr.tech/Bitcanna/)

* **Minimum hardware requirements**:

| Node Type | CPU | RAM  | Storage |
| --------- | --- | ---- | ------- |
| Mainnet   | 8   | 16GB | 250GB   |

## 1) Auto\_install script

```bash
source <(curl -s https://raw.githubusercontent.com/111STAVR111/props/refs/heads/main/Bitcanna/bitcanna)
```

## 2) Manual installation

#### Preparing the server

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc git jq chrony liblz4-tool -y
```

### GO 1.23.1

```bash
ver="1.23.1"
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
```

## Build 20.12.24

```bash
cd $HOME && mkdir $HOME/go/bin/
git clone https://github.com/BitCannaGlobal/bcna
cd bcna
git checkout v4.0.3
make install
```

`bcnad version --long | grep -e commit -e version`

* version: v4.0.3
* commit: 31b9df6390a6c06deb0f7b954293fae5d7d508ea

## Initiation

```python
bcnad init STAVR_guide --chain-id=bitcanna-1
bcnad config chain-id bitcanna-1
```

### Create/recover wallet

```bash
bcnad keys add <walletname>
           OR
bcnad keys add <walletname> --recover
```

### Download Genesis

```python
wget -L -O $HOME/.bcna/config/genesis.json https://server-1.stavr.tech/Mainnet/Bitcanna/genesis.json
```

`sha256sum $HOME/.bcna/config/genesis.json`

* cd7449a199e71c400778f894abb00874badda572ac5443b7ec48bb0aad052f29

### Set up the minimum gas price and Peers/Seeds/Filter peers/MaxPeers

```bash
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0ubcna\"/;" ~/.bcna/config/app.toml
sed -i -e "s/^filter_peers *=.*/filter_peers = \"true\"/" $HOME/.bcna/config/config.toml
external_address=$(wget -qO- eth0.me) 
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.bcna/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.bcna/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.bcna/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.bcna/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 50/g' $HOME/.bcna/config/config.toml
```

#### Pruning (optional)

```bash
pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="100"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.bcna/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.bcna/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.bcna/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.bcna/config/app.toml
```

#### Indexer (optional)

```bash
indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.bcna/config/config.toml
```

### Download addrbook

```bash
wget -O $HOME/.bcna/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Bitcanna/addrbook.json"
```

## Create a service file

```bash
sudo tee /etc/systemd/system/bcnad.service > /dev/null <<EOF
[Unit]
Description=bitcanna
After=network-online.target

[Service]
User=$USER
ExecStart=$(which bcnad) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF
```

## StateSync Bitcanna Mainnet

```bash
systemctl stop bcnad
SNAP_RPC=https://bitcanna.rpc.m.stavr.tech:443
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 1000)); \
TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH

sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \
s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"| ; \
s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.bcna/config/config.toml
bcnad tendermint unsafe-reset-all --home /root/.bcna
wget -O $HOME/.bcna/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Bitcanna/addrbook.json"
sudo systemctl restart bcnad && journalctl -fu bcnad -o cat
```

## SnapShot Mainnet updated every 5 hours

{% hint style="success" %} <mark style="color:orange;">**You can check the size and time of snapshot creation with this command**</mark>\
&#x20;`curl -sI https://server-1.stavr.tech/Mainnet/Bitcanna/bcna-snap-1.tar.lz4 | grep "last" && curl -sI https://server-1.stavr.tech/Mainnet/Bitcanna/bcna-snap-1.tar.lz4 | grep content-length | awk '{printf "%.2f GB\n", $2/1024/1024/1024}'`
{% endhint %}

```bash
cd $HOME
apt install lz4
sudo systemctl stop bcnad
cp $HOME/.bcna/data/priv_validator_state.json $HOME/.bcna/priv_validator_state.json.backup
rm -rf $HOME/.bcna/data
LATEST_SNAPSHOT=$(curl -s https://server-1.stavr.tech/Mainnet/Bitcanna/ | grep -oE 'bcna-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-1.stavr.tech/Mainnet/Bitcanna/${SNAPSHOT%.tar.lz4}-info.txt" | awk '/Block height:/ {print $3}'); echo "$SNAPSHOT $HEIGHT"; done | sort -k2 -nr | head -n 1 | awk '{print $1}')
curl -o - -L https://server-1.stavr.tech/Mainnet/Bitcanna/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.bcna
mv $HOME/.bcna/priv_validator_state.json.backup $HOME/.bcna/data/priv_validator_state.json
wget -O $HOME/.bcna/config/addrbook.json "https://server-1.stavr.tech/Mainnet/Bitcanna/addrbook.json"
sudo systemctl restart bcnad && journalctl -fu bcnad -o cat
```

### Start

```bash
sudo systemctl daemon-reload
sudo systemctl enable bcnad
sudo systemctl restart bcnad && sudo journalctl -fu bcnad -o cat
```

#### Create validator

```python
bcnad tx staking create-validator \
--amount=1000000ubcna \
--broadcast-mode=block \
--pubkey=`bcnad tendermint show-validator` \
--moniker=STAVR_guide \
--commission-rate="0.1" \
--commission-max-rate="0.20" \
--commission-max-change-rate="0.1" \
--min-self-delegation="1" \
--from=<walletName> \
--chain-id=bitcanna-1 \
--gas=auto -y
```

## [🧩Services and Tools🧩](https://stavr-team.gitbook.io/nodes-guides/mainnets/bitcanna/statesync-snapshot)

## Monitoring

You can set up your node status alarm here - [Monitoring](https://stavr-team.gitbook.io/nodes-guides/monitoring)

## Security

You can create secure management of your wallet and your node by following this links.

[TMKMS](https://stavr-team.gitbook.io/nodes-guides/tmkms)               [Wallet Security](https://stavr-team.gitbook.io/nodes-guides/wallet-security)

### Delete node

```bash
sudo systemctl stop bcnad
sudo systemctl disable bcnad
rm /etc/systemd/system/bcnad.service
sudo systemctl daemon-reload
cd $HOME
rm -rf bcna
rm -rf .bcna
rm -rf $(which bcnad)
```