# Node Installation

## [EXPLORER](https://explorer.stavr.tech/Fiamma-Testnet/staking)

* **Minimum hardware requirements**:

| Node Type | CPU | RAM | Storage |
| --------- | --- | --- | ------- |
| Testnet   | 4   | 8GB | 150GB   |

## 1) Auto\_install script

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

## 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.21.6

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

```bash
cd $HOME && mkdir -p go/bin/
git clone https://github.com/fiamma-chain/fiamma/
cd fiamma
git checkout v1.0.0
make install
```

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

* version: v1.0.0
* commit: 0de42957f85fb482cd4b2894ad85bce22a21f1aa

## Initiation

```python
fiammad	init STAVR_Guide --chain-id=fiamma-testnet-1
```

### Create/recover wallet

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

### Download Addrbook and Genesis

```python
wget -O $HOME/.fiamma/config/addrbook.json "https://server-1.stavr.tech/Testnet/Fiamma/addrbook.json"
wget -O $HOME/.fiamma/config/genesis.json "https://server-1.stavr.tech/Testnet/Fiamma/genesis.json"
```

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

* 7ca94c488926ed7dd4bb235edc629dc02a71ac02ba152b24049c3a3eae55b137

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

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

#### Pruning (optional)

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

#### Indexer (optional)

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

## Create a service file

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

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

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

## StateSync Fiamma Testnet

```bash
systemctl stop fiammad
SNAP_RPC=https://fiamma.rpc.t.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/.fiamma/config/config.toml
fiammad tendermint unsafe-reset-all --home /root/.fiamma
wget -O $HOME/.fiamma/config/addrbook.json "https://server-1.stavr.tech/Testnet/Fiamma/addrbook.json"
sudo systemctl restart fiammad && journalctl -fu fiammad -o cat
```

## SnapShot Testnet 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> \
`curl -sI https://server-1.stavr.tech/Testnet/Fiamma/fiamma-snap-1.tar.lz4 | grep "last" && curl -sI https://server-1.stavr.tech/Testnet/Fiamma/fiamma-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 fiammad
cp $HOME/.fiamma/data/priv_validator_state.json $HOME/.fiamma/priv_validator_state.json.backup
rm -rf $HOME/.fiamma/data
LATEST_SNAPSHOT=$(curl -s https://server-1.stavr.tech/Testnet/Fiamma/ | grep -oE 'fiamma-snap-[0-9]+\.tar\.lz4' | while read SNAPSHOT; do HEIGHT=$(curl -s "https://server-1.stavr.tech/Testnet/Fiamma/${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/Testnet/Fiamma/$LATEST_SNAPSHOT | lz4 -c -d - | tar -x -C $HOME/.fiamma
mv $HOME/.fiamma/priv_validator_state.json.backup $HOME/.fiamma/data/priv_validator_state.json
wget -O $HOME/.fiamma/config/addrbook.json "https://server-1.stavr.tech/Testnet/Fiamma/addrbook.json"
sudo systemctl restart fiammad && journalctl -fu fiammad -o cat
```

### Start

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

#### Create validator

```python
#pubkey
fiammad tendermint show-validator --home $HOME/.fiamma
cd $HOME
nano /root/.fiamma/validator.json
{
  "pubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"mxxxxxwxrD2L24Glxxxxxxxxxxxxxxxxxxx="},
  "amount": "1000000ufia",
  "moniker": "STAVR_Guide",
  "identity": "",
  "website": "",
  "security": "",
  "details": "",
  "commission-rate": "0.05",
  "commission-max-rate": "0.05",
  "commission-max-change-rate": "0.05",
  "min-self-delegation": "1"
}

fiammad --home $HOME/.fiamma tx staking create-validator $HOME/.fiamma/validator.json --from WAlletName  --chain-id fiamma-testnet-1 -y

```

## [🧩Services and Tools🧩](https://stavr-team.gitbook.io/nodes-guides/testnets/fiamma/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 fiammad
sudo systemctl disable fiammad
rm /etc/systemd/system/fiammad.service
sudo systemctl daemon-reload
cd $HOME
rm -rf fiamma
rm -rf .fiamma
rm -rf $(which fiammad)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stavr-team.gitbook.io/nodes-guides/archive/fiamma-t-halt/node-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
