System Requirements

This page contains system requirements you should have to be able to install and run your humanode properly.

Hardware requirements

  • 4 CPU Cores

  • 4 GB RAM

  • 160 GB disk space

  • 100 Mbps internet connection

Supported platforms

We currently support the following platforms:

  • Ubuntu 20.04 (amd64)

  • macOS 12+ (both Intel and Apple Silicon)

Ubuntu 22.04 is NOT supported.

Windows is NOT supported, but you can use WSL (Windows Subsystem for Linux) to run the Ubuntu version. WSL 2 is required. See Windows section for more info.


If you're on Windows, you'll need to use Windows Subsystem for Linux v2 (WSL 2) to run the humanode-peer. Native Windows binaries are not provided.

To install WSL on Windows, follow the official guide from Microsoft.

Then install the Ubuntu 20.04 LTS from Microsoft Store.

System time

One of the most common but difficult-to-find issues is that the time in your OS is not accurate. For a distributed system like blockchain, having a correctly set time is important, as the synchronization algorithms rely on it. Even a small drift from the network time will cause your node to produce invalid blocks, preventing you from properly participating in the consensus.

Therefore, please, configure your system to use NTP for automatic time synchronization. As long as you're using an OS with correctly implemented system clocks, the timezone you are using is irrelevant, and won't affect the correctness of the consensus. However, if you have issues (i.e. you're on Windows), you should set your system time zone to UTC. You can use online clock to tell if your system time is drifting from the commonly accepted time.

Last updated