Miners
Mining on Basilica
Earn emissions by running GPU nodes on the Basilica network.
Quick Start
Already have your GPU nodes prepared? Here's the short version:
# 1. Generate SSH key for node access
ssh-keygen -t ed25519 -f ~/.ssh/miner_node_key -N ""
# 2. Deploy key to GPU nodes
ssh-copy-id -i ~/.ssh/miner_node_key.pub basilica@<gpu_node_ip>
# 3. Create config
cat > miner.toml <<EOF
[bittensor]
wallet_name = "your_wallet"
hotkey_name = "your_hotkey"
external_ip = "your_public_ip"
axon_port = 50051
network = "finney"
netuid = 39
chain_endpoint = "wss://entrypoint-finney.opentensor.ai:443"
[database]
url = "sqlite:///opt/basilica/data/miner.db"
[node_management]
nodes = [
{ host = "<node_ip>", port = 22, username = "basilica", gpu_category = "H100", gpu_count = 8 },
# Add extra_mount_path = "/ephemeral" if you have dedicated NVMe/SSD storage
]
[ssh_session]
miner_node_key_path = "~/.ssh/miner_node_key"
default_node_username = "basilica"
[validator_assignment]
strategy = "highest_stake"
[bidding.strategy.static.static_prices]
H100 = 2.50
EOF
# 4. Run with Docker Compose
cp ./scripts/miner/compose.prod.yml compose.yml
docker compose up -d
# 5. Verify
docker compose logs -f miner
# Look for "Node registered" and "Validator authenticated" messagesNew to mining? Start with Requirements and Setup. Your nodes need specific preparation (NVIDIA runtime, firewall rules, bare metal access) before the miner will work.
What do you need?
- Miner server: Linux with a public IP. CPU only, no GPU required.
- GPU node(s): Bare metal or VM (not containers). CUDA 12.8+, Docker with NVIDIA runtime.
- Bittensor wallet: Registered on subnet 39 (mainnet)
How It Works
Your miner faithfully orchestrates validator access to your GPU nodes via SSH. No executor binaries needed.
- Miner discovers the highest-stake validator via the Bittensor metagraph
- Registers nodes with SSH details and pricing via gRPC
- Deploys the validator's SSH key to your GPU nodes
- Sends periodic health checks to keep registrations active
- Validator connects directly to your nodes for validation and rentals
Miner ──RegisterBid──> Validator
Miner ──Deploy SSH Key──> GPU Nodes
Validator ──SSH──> GPU Nodes (validation + rentals)
Miner ──HealthCheck──> Validator (periodic)Next Steps
- Requirements: Prepare your GPU nodes
- Setup: Configure and deploy the miner
- Emissions: Understand how you earn