This guide will explain how to install the gaiad
and gaiacli
entrypoints onto your system. With these installed on a server, you can participate in the latest testnet as either a Full Node or a Validator.
Install go
by following the official docs. Remember to set your $GOPATH
, $GOBIN
, and $PATH
environment variables, for example:
mkdir -p $HOME/go/bin
echo "export GOPATH=$HOME/go" >> ~/.bash_profile
echo "export GOBIN=$GOPATH/bin" >> ~/.bash_profile
echo "export PATH=$PATH:$GOBIN" >> ~/.bash_profile
::: tip Go 1.11.5+ is required for the Cosmos SDK. :::
Next, let's install the latest version of Gaia. Here we'll use the master
branch, which contains the latest stable release.
If necessary, make sure you git checkout
the correct
released version.
mkdir -p $GOPATH/src/github.com/cosmos
cd $GOPATH/src/github.com/cosmos
git clone https://github.com/cosmos/cosmos-sdk
cd cosmos-sdk && git checkout master
make tools install
NOTE: If you have issues at this step, please check that you have the latest stable version of GO installed.
That will install the gaiad
and gaiacli
binaries. Verify that everything is OK:
$ gaiad version --long
$ gaiacli version --long
gaiacli
for instance should output something similar to:
cosmos-sdk: 0.31.2-10-g1fba7308
git commit: 1fba7308fa226e971964cd6baad9527d4b51d9fc
vendor hash: 1aec7edfad9888a967b3e9063e42f66b28f447e6
build tags: netgo ledger
go version go1.11.5 linux/amd64
Build tags indicate special features that have been enabled in the binary.
Build Tag | Description |
---|---|
netgo | Name resolution will use pure Go code |
ledger | Ledger devices are supported (hardware wallets) |
Gaia can be installed on various GNU/Linux distributions from the Snapcraft.io store:
$ sudo snap install gaia
Development builds are available through the edge
channel:
$ sudo snap install --edge gaia
::: tip
At the time of writing, only the following architectures are supported: amd64
i386
arm64
armhf
ppc64el
s390x
.
:::
snap
installs Gaia binaries as gaia.gaiad
and gaia.gaiacli
. It is recommended to create commands aliases for the user's convenience once the package is installed:
$ sudo snap alias gaia.gaiad gaiad
$ sudo snap alias gaia.gaiacli gaiacli
::: warning Note that the binaries provided by the snap package save their data into $HOME/snap/gaia/ instead of $HOME. :::
Please refer to Snap documentation for specific information on how to install snap
on your distribution.
Now you can join the public testnet or create you own testnet