AVA Node setup on MacOs for Newbies

Gbolahan Ethan Onadeko
4 min readMay 28, 2020

--

Requirements

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

  • Hardware: CPU > 2 GHz, RAM > 3 GB, Storage > 5 GB free space.
  • Mac OS X >= Catalina.
  • Software: Go >= 1.13

Install Xcode

Xcode is an integrated development environment (IDE) for macOS containing a suite of software development tools developed by Apple for developing software for macOS, iOS, iPadOS, watchOS, and tvOS.

Step 1: Click search and type terminal

terminal

You should get a screen that looks like this once you launch the terminal.

terminal

Now type the following in your terminal.

xcode-select --install

You will get a screen like below you have xcode installed.

If it is not installed you will get something like this.

click Install

A License Agreement may appears, please read it and then click Agree.

Check again to see if Xcode Command Line Tools is installed. You can do this by opening a new terminal and typing in the command below.

xcode-select -p
Shows xcode is installed

Install Homebrew

Open a terminal and paste the following line.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Follow the steps in the terminal which includes you pressing the Return key and may require password if your mac is password protected.

installing homebrew

When Homebrew installed successfully you should get a screen like the one below.

To check your Homebrew.

brew --version

Install GO

We will be installing Go v1.13.

Open a terminal and type the line below in it.

curl -o golang.pkg https://dl.google.com/go/go1.13.3.darwin-amd64.pkg

When the package is downloaded type the below in your terminal.

sudo open golang.pkg

Complete the steps required to install golang.

Setup Go Workspace

Now we need to set environment variables, Setting 3 environment variables as GOROOT, GOPATH and PATH.

GOROOT is the location where Go package is installed on your system.

export GOROOT=/usr/local/go

GOPATH is the location of your work directory. For example my project directory is ~/Projects/work .

export GOPATH=$HOME/Projects/work

Now set the PATH variable to access go binary system wide.

export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

Checking Go version.

go version

you should get.

go version go1.13.3 darwin/amd64

We have now installed Xcode, Homebrew and Golang.

In your terminal insert the line below.

export GOPATH=$HOME/Projects/work

The above will set your GOPATH to Projects/works in your user folder.

Now we will download GECKO from Avalabs repo.

go get -v -d github.com/ava-labs/gecko/...

Give it a few seconds to download then.

cd $GOPATH/src/github.com/ava-labs/gecko

The above will Change to the gecko directory then run.

./scripts/build.sh
build.sh downloading required files
build done successfully

Now we can run our Ava node using.

./build/ava

You would get a popup to allow connection, you need to accept it.

Then you will get a screen like the one below.

Gecko running

Now create a new terminal window : New window with Profile-Basic.

Then you set your GOPATH to your projects folder.

export GOPATH=$HOME/Projects/work

Now you can run any command to interact with the AVA node.

Visit the AVA DOC on how to become a validator and stake.

Link : https://docs.ava.network/v1.0/en/quickstart/ava-getting-started/#create-a-keystore-user

I hope this tutorial helps.

Please check out.

--

--