Deploy Polygon nodes in Google Cloud


In this document we will describe how to deploy Polygon nodes onto VM instance in Google Cloud

Hardware requirements

Check minimum and recommended hardware requirements in Polygon docs

Software requirements

Use any modern Debian or Ubuntu Linux OS with long term support, f.e. Debian 11, Ubuntu 21.04. We'll focus on Ubuntu 21.04 in this manual

Deploy instance (2 ways)

You may use at least two ways to create an instance in Google Cloud:

We'll cover the first case in this manual. Let's start from deploy using CLI.

  1. Follow "Before you begin" section to install and configure gcloud command-line tool. Pay attention to default region and zone, choose ones closer to You or Your customers. You may use to measure latency to choose the closest location.

  2. Adjust the following command variables using Your favorite editor prior executing, when required

    • POLYGON_NETWORK - choose mainnet or mumbai testnet network to run
    • POLYGON_NODETYPE - choose archive,fullnode node type to run
    • POLYGON_BOOTSTRAP_MODE - choose bootstrap mode snapshot or from_scratch
    • POLYGON_RPC_PORT - choose JSON RPC bor node port to listen on, default value is what used on VM instance creation and in firewall rules
    • INSTANCE_NAME - name of a VM instance with Polygon we're going to create
    • INSTANCE_TYPE - GCP machine type, default value is recommended, You may change it later if required
    • BOR_EXT_DISK_SIZE - additional disk size in GB to use with Bor, default value with fullnode is recommended, You may expand it later if required. You'll need 8192GB+ with archive node though
    • HEIMDALL_EXT_DISK_SIZE - additional disk size in GB to use with Heimdall, default value is recommended
    • DISK_TYPE - GCP disk type, SSD is highly recommended
  3. Use the following command to create an instance with correct hardware and software requirements. In the example below we deploy Polygon mainnet from snapshot with fullnode mode:

export POLYGON_NETWORK=mainnet
export POLYGON_NODETYPE=fullnode
export POLYGON_RPC_PORT=8747
export GCP_NETWORK_TAG=polygon
gcloud compute firewall-rules create "polygon-p2p" --allow=tcp:26656,tcp:30303,udp:30303 --description="polygon p2p" --target-tags=${GCP_NETWORK_TAG}
gcloud compute firewall-rules create "polygon-rpc" --allow=tcp:${POLYGON_RPC_PORT} --description="polygon rpc" --target-tags=${GCP_NETWORK_TAG}
export INSTANCE_NAME=polygon-0
export INSTANCE_TYPE=e2-standard-8
export BOR_EXT_DISK_SIZE=1024
export DISK_TYPE=pd-ssd
gcloud compute instances create ${INSTANCE_NAME} \
--image-project=ubuntu-os-cloud \
--image-family=ubuntu-2104 \
--boot-disk-size=20 \
--boot-disk-type=${DISK_TYPE} \
--machine-type=${INSTANCE_TYPE} \
--create-disk=name=${INSTANCE_NAME}-bor,size=${BOR_EXT_DISK_SIZE},type=${DISK_TYPE},auto-delete=no \
--create-disk=name=${INSTANCE_NAME}-heimdall,size=${HEIMDALL_EXT_DISK_SIZE},type=${DISK_TYPE},auto-delete=no \
--tags=${GCP_NETWORK_TAG} \
- screen -dmS polygon su -l -c bash -c "curl -L | bash -s -- -n '${POLYGON_NETWORK}' -m '${POLYGON_NODETYPE}' -s '${POLYGON_BOOTSTRAP_MODE}' -p '${POLYGON_RPC_PORT}'; bash"'

Instance should be created during a couple of minutes

Login to instance (optional)

It will take a couple of minutes to install all the required software and a couple of hours to download a snapshot, when chosen. You should see working bor and heimdalld processes filling up additional drives. You may run following commands to check it. Connect to instance SSH service using gcloud SSH wrapper:

gcloud compute ssh ${INSTANCE_NAME}
# inside connected session
sudo su -
ps uax|egrep "bor|heimdalld"
df -l -h

You may use following command to watch the installation progress, it's really handy in case of snapshot bootstrap

# inside connected session
screen -dr

Use Control+a d key combination to disconnect from progress review.

You may use following commands to get Bor and Heimdall logs:

# inside connected session
journalctl -fu bor
journalctl -fu heimdalld

Please note blockchain data is saved onto additional drives which is kept by default on VM instance removal. You need to remove additional disks manually if you don't need this data anymore.

At the end You'll get an instance as shown on the diagram below

If you hit an issue with this manual - please feel free to open an issue or create a PR on GitHub.

Last updated on