Maya Protocol One-Stop-Shop
Ask or search…

Fullnode Installation Guide

Chain ID: mayachain-mainnet-v1 | Current Node Version: v1.108.0

Install Go and other requirements

Install Go
We will use Go v1.20.0 as an example here. The code below also cleanly removes any previous Go installation.
sudo rm -rvf /usr/local/go/
sudo tar -C /usr/local -xzf go1.20.12.linux-amd64.tar.gz
rm go1.20.0.linux-amd64.tar.gz
Configure Go
Unless you want to configure in a non-standard way, then set these in the ~/.bash_profile for bash and ~/.zshrc for zsh.
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin
Install protobuf-compiler
apt-get update
apt-get install -y git make protobuf-compiler
Install docker and docker compose plugin

Install Node

Install the current version of node binary.
*You can see tags in mayanode's repo tags​
git clone
cd mayanode
git checkout <latest version tag>
make openapi protob

Install binary

TAG=mainnet NET=mainnet make install

Run Node

MAYA_COSMOS_TELEMETRY_ENABLED=true CHAIN_ID=mayachain-mainnet-v1 NET=mainnet SEEDS=, bash ./build/scripts/
Create Service File
Create a mayanode.service file in the /etc/systemd/system folder with the following code snippet. Make sure to replace USER with your Linux username. You need sudo privilege to do this step.
ExecStartPre=/home/USER/.go/bin/mayanode render-config
ExecStart=/home/USER/.go/bin/mayanode start
Download Snapshot
Please use a snapshot in order to avoid syncing from start. You will need to install aws-cli​
mkdir -p ~/.mayanode/data
aws s3 cp --recursive s3://public-snapshots-mayanode/full/<snapshot height> ~/.mayanode/data
Start Node Service
# Enable service
sudo systemctl enable mayanode.service
# Start service
sudo systemctl start mayanode
# Check logs
sudo journalctl -feu mayanode

Other Considerations

This installation guide is the bare minimum to get a node started. You should consider the following as you become a more experienced node operator.
  • Configure firewall to close most ports while only leaving the p2p port (typically 27146) open
  • Use custom ports for each node so you can run multiple nodes on the same server
If you find a bug in this installation guide, please reach out to our Discord Server and let us know.