Run a Home Node

Support the Lethean network and earn staking rewards from home.

What You Get

A full chain node that syncs and validates the blockchain
Automatic PoS (Proof of Stake) staking — earn LTHN for securing the network
P2P peering — other nodes connect to yours

Requirements

Linux with Docker installed
2GB RAM, 10GB disk space
Internet connection (no static IP needed for basic node)

Quick Start

# Download the compose file
curl -O https://forge.lthn.ai/lthn/blockchain/raw/branch/dev/docker/docker-compose.node.yml
curl -O https://forge.lthn.ai/lthn/blockchain/raw/branch/dev/docker/.env.example

# Configure
cp .env.example .env
# Edit .env — set WALLET_PASSWORD

# Start
docker compose -f docker-compose.node.yml up -d

Check Status

# Chain sync progress
docker logs lthn-node --tail 5

# Wallet balance (staking rewards accumulate here)
curl -s http://localhost:46944/json_rpc \
  -d '{"jsonrpc":"2.0","id":"0","method":"getbalance"}' \
  -H 'Content-Type: application/json'

# Your wallet address (share this to receive LTHN)
curl -s http://localhost:46944/json_rpc \
  -d '{"jsonrpc":"2.0","id":"0","method":"getaddress"}' \
  -H 'Content-Type: application/json'

Optional: Open P2P Port

For a full node that helps the network, open port 46942 TCP on your router. This lets other nodes connect to you directly.

Without port forwarding your node still works — it connects outward to other nodes but can't accept incoming connections.

Optional: GPU Mining

Connect a ProgPoWZ miner to earn additional block rewards:

progminer -P stratum+tcp://YOUR_WALLET_ADDRESS@localhost:5555

This requires running the mining pool alongside your node. See the Mining Guide.

Staking Rewards

Your wallet stakes automatically via --do-pos-mining. Rewards are proportional to your balance — the more LTHN you hold, the more frequently you'll earn PoS blocks.

Metric	Value
Block reward	1 LTHN
Block time	~120 seconds
PoS blocks per day	~720
Minimum stake	Any amount (no minimum)
Lock time	None (stake and spend freely)

Backup Your Wallet

docker compose -f docker-compose.node.yml stop wallet
docker cp lthn-wallet:/wallet ./wallet-backup-$(date +%Y%m%d)
docker compose -f docker-compose.node.yml start wallet

Keep your wallet backup safe. If you lose it, you lose your LTHN.

Stopping

docker compose -f docker-compose.node.yml down        # stop (keeps data)
docker compose -f docker-compose.node.yml down -v      # stop + delete everything