Installation

Comprehensive tool to automate Lumera Network mainnet node setup with Cosmovisor support.

This script is a comprehensive tool that automates the Lumera Network mainnet node installation. It comes with Cosmovisor support and provides a user-friendly menu interface.

💢 Features

✅ Automatic Go version checking and installation
✅ Automatic upgrade support with Cosmovisor
✅ Automatic snapshot downloading and applying
✅ Multi-language support (Turkish/English)
✅ Interactive menu system
✅ Wallet management (create/import)
✅ Validator creation and management
✅ Token operations (delegate/transfer)
✅ Real-time log viewing
✅ Sync status check

💻 System Requirements

💢 Minimum Requirements

CPU: 4 Core
RAM: 8 GB
Disk: 200 GB SSD
OS: Ubuntu 20.04 or higher

💢 Recommended Requirements

CPU: 8 Core
RAM: 16 GB
Disk: 500 GB NVMe SSD
OS: Ubuntu 22.04 LTS

💢 Quick Start

💢 One-Command Installation

wget -O lumera-setup.sh https://raw.githubusercontent.com/Edsny1/Lumera-Mainnet-Setup/refs/heads/Edsny/lumera-setup.sh && chmod +x lumera-setup.sh && ./lumera-setup.sh

💢 Detailed Installation Steps

💢 1. Download Script

# Download the script
wget https://raw.githubusercontent.com/Edsny1/Lumera-Mainnet-Setup/refs/heads/Edsny/lumera-setup.sh

# Give execution permission
chmod +x lumera-setup.sh

# Run the script
./lumera-setup.sh

💢 2. Language Selection

When the script starts, you will be prompted to select a language:

1 - English
2 - Türkçe

After installation is complete, you will see the following menu options:

╔════════════════════════════════════════╗
║          ANA MENÜ / MAIN MENU          ║
╚════════════════════════════════════════╝

1)  Kurulum Yap / Install Node
2)  Sync Durumu Kontrol Et / Check Sync Status
3)  Logları Görüntüle / View Logs
4)  Cüzdan Oluştur / Create Wallet
5)  Cüzdan İçe Aktar / Import Wallet
6)  Validator Oluştur / Create Validator
7)  Token Delege Et / Delegate Tokens
8)  Token Gönder / Send Tokens
9)  Bakiye Kontrol Et / Check Balance
0)  Çıkış / Exit

💢 Installation Processes

The script automatically:

Installs system dependencies
Checks Go 1.23.5 version and installs if necessary
Downloads Lumera binaries
Installs and configures Cosmovisor
Initializes the node
Downloads genesis and addrbook files
Downloads and applies the snapshot
Creates and starts the systemd service

💢 Wallet Operations

# Use the menu option inside the script
# Enter a wallet name
# Save your mnemonic phrase in a safe place!

# Use the menu option inside the script
# Enter a wallet name
# Enter your mnemonic phrase

When creating a validator, you will be prompted to enter the following information:

Wallet Name: Wallet to be used for the validator
Moniker: Validator name
Identity: Keybase identity number (optional)
Website: Your website (optional)
Security Contact: Contact email
Details: Validator description
Commission Rate: Commission rate (e.g. 0.05 = 5%)
Max Rate: Maximum commission rate (e.g. 0.20 = 20%)
Max Change Rate: Maximum change rate (e.g. 0.01 = 1%)
Min Self Delegation: Minimum self delegation
Amount: Stake amount (e.g. 1000000ulume)

💢 Useful Commands

💢 Node Status

# Service status
sudo systemctl status lumerad

# View logs
sudo journalctl -u lumerad -f

# Node info
lumerad status 2>&1 | jq

💢 Wallet Commands

# List wallets
lumerad keys list

# Wallet balance
lumerad query bank balances $(lumerad keys show WALLET_NAME -a)

# Show wallet address
lumerad keys show WALLET_NAME -a

💢 Validator Commands

# Validator info
lumerad query staking validator $(lumerad keys show WALLET_NAME --bech val -a)

# Active validator set
lumerad query staking validators --limit 1000 -o json | jq -r '.validators[] | select(.status=="BOND_STATUS_BONDED") | [.operator_address, .description.moniker, .status] | @csv' | column -t -s','

# Unjail
lumerad tx slashing unjail --from WALLET_NAME --chain-id lumera-mainnet-1 --gas auto --gas-adjustment 1.4 --fees 500ulume -y

💢 Manual Configuration

💢 Changing Port

The script uses port 10 by default. If you want to use a different port:

# Edit .bash_profile file
nano ~/.bash_profile

# Change LUMERA_PORT value
export LUMERA_PORT="20"  # Example: 20

# Apply changes
source ~/.bash_profile

💢 Cosmovisor Configuration

Cosmovisor environment variables:

DAEMON_NAME=lumerad
DAEMON_HOME=$HOME/.lumera
DAEMON_ALLOW_DOWNLOAD_BINARIES=false
DAEMON_RESTART_AFTER_UPGRADE=true
UNSAFE_SKIP_BACKUP=true

💢 Monitoring

💢 Prometheus Metrics

Your node provides Prometheus metrics:

http://localhost:10660/metrics

💢 Log Levels

To change the log level:

lumerad config log_level "info"

Available levels: debug, info, warn, error

💢 Security

💢 Security Recommendations

Firewall Configuration:

# Enable UFW
sudo ufw enable

# SSH port
sudo ufw allow 22

# P2P port
sudo ufw allow 10656

# RPC port (localhost only)
sudo ufw allow from 127.0.0.1 to any port 10657

Mnemonic Phrase:
- Never share your mnemonic phrase with anyone
- Back it up in a safe place (paper, encrypted USB)
- Do not store it digitally
Private Key:
- Encrypt your private key files
- Make regular backups

💢 Troubleshooting

💢 Node is Not Syncing

# Check the number of peers
curl -s localhost:10657/net_info | jq -r '.result.n_peers'

# Add seed/peer
# Edit config.toml file
nano ~/.lumera/config/config.toml

💢 Disk is Full

# Check pruning settings
cat ~/.lumera/config/app.toml | grep pruning

# Clear log files
sudo journalctl --vacuum-time=3d

💢 Service Does Not Start

# Check error logs
sudo journalctl -u lumerad -n 100

# Check binary version
lumerad version

# Verify configuration
lumerad validate-genesis

💢 Additional Resources

Official Docs: Lumera Docs
Discord: Lumera Discord
Explorer: Lumera Explorer
Telegram: Lumera Telegram