Skip to main content


This document outlines the different methods available for installing the Polygon Supernet binaries.

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.

To install and run Supernets, you have several options. The tabs below provide guides for each installation method. You can choose to use pre-built releases, a Docker image, or build from source.


We recommend using the pre-built releases and verifying the provided checksums for security.

The Docker image is also a convenient option for containerized deployment. Building from source provides greater flexibility, but requires a suitable development environment.

If you encounter any issues during the installation process, refer to the troubleshooting guide which will be available soon.

Latest release: 1.0.0-rc1

The latest stable test release is v1.0.0-rc1

To access the pre-built releases, visit the GitHub releases page. The client provides cross-compiled AMD64/ARM64 binaries for Darwin and Linux.

[For reference] Extract pre-release package

Extract the downloaded package using your file system's extraction tool or the provided commands below, and navigate to the pre-built release in your preferred interface or text editor.

# replace <downloaded_package> with the actual package filename

tar -xzf <downloaded_package>
cd <downloaded_package>