Official node implementation of the Avalanche network - a blockchains platform with high throughput, and blazing fast transactions.


Avalanche is an incredibly lightweight protocol, so the minimum computer requirements are quite modest.

  • Hardware: 2 GHz or faster CPU, 4 GB RAM, 2 GB hard disk.
  • OS: Ubuntu >= 18.04 or Mac OS X >= Catalina.
  • Software: Go version >= 1.15.5 and set up $GOPATH.
  • Network: IPv4 or IPv6 network connection, with an open public port.

Native Install

Clone the AvalancheGo repository:

go get -v -d github.com/ava-labs/avalanchego/...
cd $GOPATH/src/github.com/ava-labs/avalanchego

Building the Avalanche Executable

Build Avalanche using the build script:


The Avalanche binary, named avalanchego, is in the build directory.

Docker Install

  • Make sure you have docker installed on your machine (so commands like docker run etc. are available).
  • Build the docker image of latest avalanchego branch by ./scripts/build_image.sh.
  • Check the built image by docker image ls, you should see some image tagged
    avalanchego-xxxxxxxx, where xxxxxxxx is the commit id of the Avalanche source it was built from.
  • Test Avalanche by docker run -ti -p 9650:9650 -p 9651:9651 avalanchego-xxxxxxxx /avalanchego/build/avalanchego --network-id=local --staking-enabled=false --snow-sample-size=1 --snow-quorum-size=1. (For a production deployment,
    you may want to extend the docker image with required credentials for
    staking and TLS.)

Running Avalanche

Connecting to Mainnet

To connect to the Avalanche Mainnet, run:


You should see some pretty ASCII art and log messages.

You can use Ctrl+C to kill the node.

Connecting to Fuji

To connect to the Fuji Testnet, run:

./build/avalanchego --network-id=fuji

Creating a Local Testnet

To create a single node testnet, run:

./build/avalanchego --network-id=local --staking-enabled=false --snow-sample-size=1 --snow-quorum-size=1

This launches an Avalanche network with one node.