Use this guide to size the computer that runs Pickaxe, Foreman's agent. This is the one place in the Help Center for Pickaxe hardware numbers. Foreman itself is hosted, so there's nothing else to install.
Where to Run Pickaxe
- Run Pickaxe on a computer at your site, connected directly to the same network as your miners. It can also reach miners over a VPN, but the VPN must stay up 24/7.
- For several sites, run a separate Pickaxe at each site.
- Large fleets can be split across several smaller Pickaxes instead of one big server. Common setups:
- One computer per mining container, each Pickaxe handling about 500 miners.
- One computer for a group of containers, each Pickaxe handling several thousand miners.
- One enterprise server for a whole site, with one Pickaxe handling 10,000+ miners.
- For very large deployments, run Pickaxes on a VM cluster so they can move to another node if one fails.
Operating System
Pickaxe runs on Linux and Windows. Linux performs significantly better and is recommended. Windows isn't recommended for more than about 1,000 miners per Pickaxe, because it can run out of network ports during busy periods such as curtailments. See How To: Tune Windows For Pickaxe.
Sizing
Pickaxe's speed depends mostly on CPU. More cores and threads let it query miners and run commands in parallel. Memory and disk use are small: at least 2 GB of free memory is enough, and disk is only used for error logs.
| Miners per Pickaxe | Recommended CPU |
|---|---|
| Up to 2,500 | Intel i5 or AMD equivalent, ideally 4+ cores with hyper-threading (for example 4 cores / 8 threads) |
| 2,500 – 10,000 | Intel i7 or AMD equivalent, with at least 16 threads (for example 8 cores / 16 threads) |
| Over 10,000 | Contact us. These sites usually need an enterprise server, and often take part in curtailment programs with tight timing. |
Signs Pickaxe Needs More Resources
- Remote commands fail with Dispatch timed out.
- CPU use on the Pickaxe computer stays above about 50%.
- Miners flip between updating and not updating.
If you see these, move Pickaxe to a bigger machine, give its VM more threads, or split miners across more Pickaxes.
Related Articles
Last verified: November 19, 2026