Skip to main content

Limonata Network Installation Guide

Official public testnet installation guide for Limonata Network brought to you by INCENTIVED.ORG.

Hardware Requirements​

ComponentMinimum Requirement
CPU4 or more physical CPU cores
MemoryAt least 8 GB RAM
StorageAt least 200 GB SSD NVMe
BandwidthAt least 100 Mbps internet connection

🔍 Official Block Explorer​

Monitor network activities, track transactions, and verify validator statuses directly on our high-performance explorer:

Step 1: Install System Dependencies​

Update your system repository and install all necessary development packages:

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 chrony liblz4-tool zip -y

Step 2: Install Go (Golang)​

Set up the recommended Go environment variable (v1.24.5) required to build and operate the network binary:

ver="1.24.5"
wget "[https://golang.org/dl/go$ver.linux-amd64.tar.gz](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"

# Configure environment paths
echo "export PATH=\$PATH:/usr/local/go/bin:\$HOME/go/bin" >> ~/.bash_profile
source ~/.bash_profile

# Verify installation
go version

Step 3: Install Node Binary​

Download the compiled testnet binary from the official release repository and move it to the execution path:

wget https://github.com/Limonata-Blockchain/limonata/releases/download/limonata-testnet-v0.2.0/limonatad-linux-amd64.tar.gz
tar xzf limonatad-linux-amd64.tar.gz
chmod +x limonatad
mv limonatad /usr/local/bin/
rm -rf limonatad-linux-amd64.tar.gz

# Check binary version
limonatad version

Step 4: Initialize the Node​

Initialize your genesis configurations. Please replace --moniker <YOUR_MONIKER> with your preferred validator identity name:

limonatad init <YOUR_MONIKER> --chain-id limonata_10777-1

Step 5: Fetch Genesis and Addrbook​

Download the latest verified Genesis file and official address book directory:

Download Genesis

curl -L https://explorer.incentived.org/snapchain/limonata/genesis.json > $HOME/.evmd/config/genesis.json

Download Addrbook

curl -L https://explorer.incentived.org/snapchain/limonata/addrbook.json > $HOME/.evmd/config/addrbook.json

Step 6: Configure Network Peers & Gas Prices​

Apply persistent node connections, configure gas prices, and adjust settings within config.toml and app.toml:

# Add seed/peers configurations
peers="3b646a426de95b28b236c51512e0c31277456460@89.117.58.134:19656"
sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"$peers\"|" $HOME/.evmd/config/config.toml

# Set minimum gas prices
sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0aLIMO\"/" $HOME/.evmd/config/app.toml

# Set node type configuration
sed -i -E "s|type = \".*\"|type = \"app\"|g" $HOME/.evmd/config/config.toml

# Disable Indexer to save storage space (Optional)
sed -i 's|^indexer *=.*|indexer = "null"|' $HOME/.evmd/config/config.toml

Step 7: Create Systemd Service & Launch Node​

Construct the system service daemon file to manage the background process and allow autostart on system reboots:

sudo tee /etc/systemd/system/limonatad.service > /dev/null <<EOF
[Unit]
Description=Limonata Testnet Node
After=network-online.target

[Service]
User=$USER
ExecStart=$(which limonatad) start --chain-id limonata_10777-1 --evm.evm-chain-id 10777 --minimum-gas-prices 0aLIMO
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Start service

sudo systemctl daemon-reload
sudo systemctl enable limonatad
sudo systemctl start limonatad

Monitor Live Sync Logs: To check whether your node is syncing blocks smoothly, run:

sudo journalctl -u limonatad -f -o cat