Prerequisites

This guide explains what the requirements are to install and run an Archway full node.

Hardware requirements:

The following hardware requirements are expected:

x86-64 (amd64) multi-core CPU (AMD / Intel)
64GB RAM
1TB NVMe SSD Storage
100Mbps bi-directional Internet connection

Install prerequisites

You can obtain archwayd by downloading the pre-built binary via:

the available releases
by using the container image via Docker.

Make sure to install Cosmovisor, as this is the recommended best practice to manage your node's workflows.

Downloading the pre-built binary

If you wish to use the pre-built binary, no specific dependency is required. Just make sure to update your local packages and installing the build-essential and git packages.

# updates and upgrades the list of local packagessudo apt-get update && sudo apt upgrade -y

# installs docker, build-essential and gitsudo apt-get install build-essential git

You can then download the pre-built binary from the latest release, and by following the instructions on the installation page.

Using the container image via Docker

If you prefer using Docker, make sure to update your local packages and installing the required docker, build-essential and git packages:

# updates and upgrades the list of local packagessudo apt-get update && sudo apt upgrade -y

# installs docker, build-essential and gitsudo apt-get install build-essential docker-ce docker-ce-cli containerd.io docker-compose-plugin git

Installing Cosmovisor

It is highly recommended to use Cosmovisor, as it is considered the standard best practice for operating nodes.

You can install Cosmovisor with:

go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@latest

and check that the installation has been successful with:

cosmovisor

You can learn more about Cosmovisor and how to configure it here.

Optional (not recommended)

We encourage users to download the pre-built binary via the release page.

However, if you wish to build the binary yourself, GoLang is required.

Building the binary with GoLang

If you wish to build the binary yourself:

Make sure to update your local packages and installing the build-essential and git packages:

# updates and upgrades the list of local packagessudo apt-get update && sudo apt upgrade -y

# installs docker, build-essential and gitsudo apt-get install build-essential git

Install Go version 1.19. Please refer to this guide on how to install Go.
Ensure the Go environment variables are set properly on your system.

As an example, on Ubuntu, you can install Go and configure the GOPATH by doing the following:

sudo apt install golang-go

Set the GOROOT and GOPATH in the ~/.profile file:

export GOROOT=/usr/local/goexport GOPATH=$HOME/goexport PATH=$PATH:$GOROOT/bin:$GOPATH/bin

Apply these changes using:

source ~/.profile

Next steps

You are ready to go! Let's go forward with installing archwayd.