Lux Docs

Guides

Step-by-step tutorials for the Lux CLI

Practical guides for common Lux CLI workflows. Each guide walks through a real-world scenario with copy-paste commands.

Getting Started

Start a local development network and deploy your first chain:

# Start a 5-node testnet
lux network start --testnet

# Check that all nodes are healthy
lux network status

# Create a new Subnet EVM chain
lux chain create mychain --evm-chain-id=12345

# Deploy it to the running network
lux chain deploy mychain --testnet

Common Workflows

WorkflowCommandsGuide
Local developmentnetwork start, chain create, chain deployStart a network and deploy a chain
Key managementkey create, key list, key exportGenerate and manage validator keys
Kubernetes deploynode deploy, node status, node logsDeploy to production Kubernetes
Rolling upgradenode upgrade --image ...Zero-downtime binary upgrade
Network snapshotsnetwork stop --snapshot-name, network start --snapshot-nameSave and restore state
AMM tradingamm balance, amm swap, amm poolsInteract with on-chain DEX

Environment Variables

VariablePurpose
LUX_PRIVATE_KEYHex-encoded private key for transactions
LUX_MNEMONICBIP-39 mnemonic (derives key at m/44'/60'/0'/0/0)
LUX_CHART_PATHPath to Helm chart for node deploy

Network Ports

ModeBase PortValidators
--mainnet96305
--testnet96405
--devnet96505
--dev85451

On this page