Benchmark Tool
The Lium benchmark tool lets you test your node's hardware against the same checks the validator
runs during verification. Use it to confirm your machine meets the requirements before the
network starts scoring it, and to diagnose why a node is failing RENTAL_CHECK_FAILED.
Quick start (network only)​
docker run --gpus all --rm daturaai/verifyx-test:latest
This runs a 10-iteration network benchmark and prints your download and upload speeds. It completes in roughly 2–3 minutes.
Full benchmark (network + storage + memory)​
docker run --gpus all --rm daturaai/verifyx-test:latest python3 benchmark.py --full
This runs all three test suites. Expect it to take 5–10 minutes due to the 5 GB storage I/O test.
What is tested​
| Test | What it measures | Minimum requirement |
|---|---|---|
| Network download | PyPI package download speed | 50 Mbps |
| Network upload | Cloudflare speedtest upload | — |
| Storage write | Sequential write throughput (5 GB) | 100 GB free space |
| Storage read | Sequential read throughput (5 GB) | — |
| Memory allocation | Allocates 75 % of available RAM (8–128 GB range) | 8 GB RAM |
Interpreting results​
The benchmark runs 10 iterations and reports an Exponential Moving Average (EMA) with
alpha = 0.3 (decay = 0.7), so recent runs carry more weight. The final printed values are
the EMA-smoothed numbers — a single slow run will not dominate the result.
The last section of the output also shows your hardware stats (total RAM, free disk space, utilization) from the most recent successful run.
Prerequisites​
Your host must have the NVIDIA Container Toolkit installed so Docker can pass GPU access
through the --gpus all flag. If you followed the Node setup guide, this is
already configured.
# Verify the toolkit is installed
docker run --gpus all --rm nvidia/cuda:12.8.1-base-ubuntu22.04 nvidia-smi
Troubleshooting​
| Symptom | Likely cause | Fix |
|---|---|---|
| Download speed below 50 Mbps | ISP throttling or congested uplink | Contact your hosting provider; consider a dedicated port |
| Storage test fails (not enough free space) | Less than 100 GB free on the executor disk | Free up disk space or resize the volume |
| Memory allocation fails | Less than 8 GB RAM available | Reduce other processes consuming RAM; upgrade RAM if needed |
--gpus all flag not recognised | NVIDIA Container Toolkit not installed | Follow the Node setup guide |