Skip to main content

System Requirements

This document provides guidance on the minimum hardware requirements and required prerequisites to run and maintain a Supernet.

Breaking changes

Supernets are rapidly evolving towards a production-ready state, and, as a result, instructions and concepts in these guides are subject to change.

Test releases include breaking changes and are not backward compatibility. Use the current test releases for testing and familiarization only.

It is highly recommended that reach out to the Supernets team for support.

Minimum Hardware Configuration

Hardware environment tips

While we do not favor any operating system, more secure and stable Linux server distributions (like CentOS) should be preferred over desktop operating systems (like Mac OS and Windows).

The minimum storage requirements will change over time as the network grows. It is recommended to use more than the minimum requirements to run a robust full node.

This is the minimum hardware configuration required to set up a Supernet:

ComponentMinimum RequirementRecommended
Processor4-core CPU8-core CPU
Memory8 GB RAM16 GB RAM
Storage200 GB SSD1 TB SSD
NetworkHigh-speed internet connectionDedicated server with gigabit connection

Note that these minimum requirements are based on the x2iezn.2xlarge instance type used in the performance tests, which demonstrated satisfactory performance. However, for better performance and higher transaction throughput, consider using more powerful hardware configurations, such as those equivalent to x2iezn.4xlarge or x2iezn.8xlarge instance types.


Before starting any of the tutorials, you should understand the basics of blockchain technology and be familiar with command-line interfaces. It would help if you also had the polygon-edge binary installed on your machine. Check out the installation guide for more information if you haven't already.

Ensure you have the following system prerequisites:

Golang (v1.15-1.19)Install Go using CLI or package manager like Snapcraft for Linux, Homebrew for Mac, or Chocolatey for Windows. Compatibility for other versions coming soon.
DockerRequired to run the geth instance. Follow official Docker documentation for installation instructions.
Internet connectionStable internet connection required.
Network securityEnsure that network ports used by Polygon Edge are not blocked by firewalls or other security measures.
Operating systemEnsure that the latest security patches and updates are installed.
Solidity v0.8.19 or earlier recommended

Solidity v0.8.20 introduces new features, including the implementation of PUSH0 opcode, which is not yet supported in Supernets. If you decide to use v0.8.20, ensure that you set your EVM version to "Paris" in the framework you use to deploy your contracts.

For now, we recommend using Solidity v0.8.19 or earlier.