LI Network Docs

Appearance

LICOIN Installation Guide ​

This guide will help you install and set up LICOIN on your system.

System Requirements ​

Minimum Requirements ​

  • CPU: 2 cores (any modern architecture)
  • RAM: 2GB
  • Storage: 10GB free space
  • Network: Broadband internet connection
  • OS: Linux, Windows 10+, or macOS 10.14+
  • CPU: 4+ cores
  • RAM: 4GB+
  • Storage: 20GB+ SSD
  • Network: Stable broadband connection

Installation Methods ​

Prerequisites ​

Ubuntu/Debian:

bash
sudo apt update
sudo apt install build-essential cmake libssl-dev libsodium-dev libcurl4-openssl-dev libjsoncpp-dev pkg-config git

CentOS/RHEL/Fedora:

bash
sudo yum install gcc-c++ cmake openssl-devel libsodium-devel libcurl-devel jsoncpp-devel pkgconfig git
# or for newer versions:
sudo dnf install gcc-c++ cmake openssl-devel libsodium-devel libcurl-devel jsoncpp-devel pkgconfig git

macOS:

bash
# Install Homebrew if not already installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install dependencies
brew install cmake openssl libsodium curl jsoncpp pkg-config

Windows:

  • Install Visual Studio 2019+ with C++ support, or
  • Install MSYS2 and required packages

Build Steps ​

  1. Clone the repository:
bash
git clone https://github.com/LI-COIN/Li-Network.git
cd LICOIN
  1. Build LICOIN:
bash
chmod +x build-from-source.sh
./build-from-source.sh
  1. Install system-wide (optional):
bash
sudo ./install.sh

Method 2: Pre-compiled Binaries ​

Download the latest release for your platform:

Linux (x64):

bash
wget https://github.com/LI-COIN/Li-Network/releases/latest/download/LICOIN-linux-x64.tar.gz
tar -xzf LICOIN-linux-x64.tar.gz
cd LICOIN-linux-x64

Windows (x64):

  1. Download LICOIN-windows-x64.zip
  2. Extract to desired location
  3. Run LICOINd.exe

macOS (x64):

bash
curl -L https://github.com/LI-COIN/Li-Network/releases/latest/download/LICOIN-macos-x64.tar.gz -o LICOIN-macos-x64.tar.gz
tar -xzf LICOIN-macos-x64.tar.gz
cd LICOIN-macos-x64

Method 3: Docker ​

bash
# Pull the official image
docker pull LICOIN/LICOIN:latest

# Run a full node
docker run -d --name LICOINd \
  -p 8333:8333 \
  -p 8332:8332 \
  -v LICOIN-data:/var/lib/LICOIN \
  LICOIN/LICOIN:latest

# Run with custom configuration
docker run -d --name LICOINd \
  -p 8333:8333 \
  -p 8332:8332 \
  -v /path/to/LICOIN.conf:/etc/LICOIN/LICOIN.conf \
  -v LICOIN-data:/var/lib/LICOIN \
  LICOIN/LICOIN:latest

Configuration ​

1. Create Configuration File ​

Create ~/.LICOIN/LICOIN.conf (Linux/macOS) or %APPDATA%\LICOIN\LICOIN.conf (Windows):

ini
# Basic configuration
rpcuser=LICOIN
rpcpassword=your_secure_password_here
rpcport=8332
port=8333

# Network settings
maxconnections=125
listen=1

# Logging
debug=1

# Mining (optional)
gen=0
genproclimit=4

2. Secure Your Configuration ​

Linux/macOS:

bash
chmod 600 ~/.LICOIN/LICOIN.conf

Windows: Right-click the file → Properties → Security → Advanced → Disable inheritance → Remove all users except yourself

3. Firewall Configuration ​

Linux (ufw):

bash
sudo ufw allow 8333/tcp comment "LICOIN P2P"

Windows:

  1. Windows Defender Firewall → Advanced Settings
  2. Inbound Rules → New Rule → Port → TCP → 8333
  3. Allow the connection

macOS:

bash
# Add firewall rule if needed
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /path/to/LICOINd

Running LICOIN ​

Starting the Daemon ​

Command Line:

bash
# Foreground (see output)
./LICOINd

# Background (daemon mode)
./LICOINd -daemon

# With custom config
./LICOINd -conf=/path/to/LICOIN.conf

Systemd Service (Linux):

bash
# Enable and start service
sudo systemctl enable LICOINd
sudo systemctl start LICOINd

# Check status
sudo systemctl status LICOINd

# View logs
journalctl -u LICOINd -f

Using the CLI ​

bash
# Get blockchain info
./LICOIN-cli getblockcount
./LICOIN-cli getblockchaininfo

# Wallet operations
./LICOIN-cli getnewaddress
./LICOIN-cli getbalance
./LICOIN-cli sendtoaddress LI1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa 10.0

# Mining info
./LICOIN-cli getmininginfo
./LICOIN-cli getdifficulty

Starting Mining ​

bash
# Solo mining
./LICOIN-miner --address LI1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa --threads 4

# Pool mining
./LICOIN-miner --pool stratum+tcp://pool.linet.work:3333 --user your_address --threads 4

# Benchmark
./LICOIN-miner --benchmark

Wallet Setup ​

CLI Wallet ​

bash
# Create new wallet
./LICOIN-wallet-cli create

# Restore from seed
./LICOIN-wallet-cli restore "your twelve word seed phrase here"

# Generate new address
./LICOIN-wallet-cli getnewaddress

# Check balance
./LICOIN-wallet-cli getbalance

# Send transaction
./LICOIN-wallet-cli send LI1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa 5.0

GUI Wallet (Future Release) ​

The GUI wallet will be available in a future release. For now, use the CLI wallet or third-party wallets.

Troubleshooting ​

Common Issues ​

1. "LICOINd: command not found"

  • Ensure binaries are in your PATH or use full path
  • If installed system-wide, try /usr/local/bin/LICOINd

2. "Connection refused" when using CLI

  • Check if LICOINd is running: ps aux | grep LICOINd
  • Verify RPC settings in LICOIN.conf
  • Check firewall settings

3. "Insufficient funds" when mining

  • Mining rewards take 100 confirmations to mature
  • Check balance with ./LICOIN-cli getbalance

4. Slow synchronization

  • Ensure good internet connection
  • Add more seed nodes to LICOIN.conf
  • Check available disk space

5. High CPU usage

  • Normal during initial sync and mining
  • Reduce mining threads if needed
  • Consider using SSD for better performance

Getting Help ​

Log Files:

  • Linux: ~/.LICOIN/debug.log
  • Windows: %APPDATA%\LICOIN\debug.log
  • macOS: ~/Library/Application Support/LICOIN/debug.log

Community Support:

Documentation:

Security Best Practices ​

1. Wallet Security ​

  • Use strong, unique passwords
  • Backup your wallet regularly
  • Store backups securely (encrypted, offline)
  • Never share private keys

2. Node Security ​

  • Keep software updated
  • Use firewall rules
  • Monitor for unusual activity
  • Regular security audits

3. Mining Security ​

  • Use dedicated mining addresses
  • Monitor mining performance
  • Secure mining pool credentials
  • Regular payout monitoring

Performance Optimization ​

1. Hardware Optimization ​

  • Use SSD for blockchain data
  • Ensure adequate RAM
  • Good network connectivity
  • Proper cooling for mining

2. Software Optimization ​

bash
# Increase database cache
echo "dbcache=1024" >> ~/.LICOIN/LICOIN.conf

# Optimize connections
echo "maxconnections=50" >> ~/.LICOIN/LICOIN.conf

# Enable transaction indexing (optional)
echo "txindex=1" >> ~/.LICOIN/LICOIN.conf

3. Network Optimization ​

  • Use wired connection when possible
  • Configure QoS for mining traffic
  • Monitor bandwidth usage
  • Use local seed nodes if available

Maintenance ​

Regular Tasks ​

Daily:

  • Check node status
  • Monitor mining performance
  • Review log files

Weekly:

  • Backup wallet
  • Update software if needed
  • Check disk space

Monthly:

  • Security audit
  • Performance review
  • Community updates

Backup Procedures ​

Wallet Backup:

bash
# CLI wallet
./LICOIN-wallet-cli backup wallet_backup_$(date +%Y%m%d).dat

# Core wallet
cp ~/.LICOIN/wallet.dat ~/backups/wallet_backup_$(date +%Y%m%d).dat

Configuration Backup:

bash
cp ~/.LICOIN/LICOIN.conf ~/backups/LICOIN_conf_backup_$(date +%Y%m%d).conf

Next Steps ​

After successful installation:

  1. Sync the blockchain - Wait for full synchronization
  2. Create a wallet - Generate your first LICOIN address
  3. Start mining - Begin earning LI tokens
  4. Join the community - Connect with other LICOIN users
  5. Explore the ecosystem - Try different wallets and tools

For more advanced topics, see:

Released under the MIT License.

Copyright © 2026-present LI Network