GateChain Full Node Setup Guide
Supported Platforms
GateChain full node currently supports Unix environments (macOS, Ubuntu, CentOS).
Hardware Requirements
Hardware must meet certain requirements to run a full node:
- Operating System: Mac OS 10.14.6 or above, CentOS Linux release 7.7.1908 or above, or Ubuntu 18.04.2 or above
- 4 CPU cores, 8GB+ RAM, and 100GB+ disk space
- Stable internet connection with at least 1MB/s bandwidth
Installation Steps
Method 1: Automated Installation Script
Note: Please ensure "wget" is installed in your environment
We maintain an installation script ("install.sh") on GitHub that handles the setup of chain executables. This uses the following defaults:
Executables are placed in "/usr/local/bin" (i.e., "gated" "gatecli")
# One-click installation (requires proxy)
bash <(wget -qO- https://raw.githubusercontent.com/gatechain/node-binary/master/node/install.sh)
# One-click installation for users in China (no proxy needed)
bash <(wget -qO- https://gatechainbucket.oss-cn-beijing.aliyuncs.com/auto-install.sh)
Note: If you're installing for the second time or more, you need to manually delete the local gated/gatecli files first.
Method 2: Custom Installation 1
We currently use this repository to store historical versions of compiled node binaries.
-
Install Git LFS Git LFS is a Git extension for managing large files. Please visit https://git-lfs.github.com/ for installation.
-
Clone the repository:
git lfs clone https://github.com/gatechain/node-binary.git
- Select the corresponding version binary according to the changelog:
cd node-binary/node/{network}/{version}/{os_type}
- Copy binaries to "/usr/local/bin":
cp gated gatecli /usr/local/bin
- Create root directory for GateChain node $GATEHOME (i.e., ~/.gated):
mkdir ~/.gated
- Copy "config.json" and "genesis.json" from "node-binary/node/{network}/{version}/config/" to "$GATEHOME/"
Method 3: Custom Installation 2
Users can choose download links based on their system requirements.
Note: Please ensure "wget" is installed in your environment
For macOS:
# Download gated
wget https://gatechainbucket.oss-cn-beijing.aliyuncs.com/binary/mac/gated
# Download gatecli
wget https://gatechainbucket.oss-cn-beijing.aliyuncs.com/binary/mac/gatecli
For Linux:
# Download gated
wget https://gatechainbucket.oss-cn-beijing.aliyuncs.com/binary/linux/gated
# Download gatecli
wget https://gatechainbucket.oss-cn-beijing.aliyuncs.com/binary/linux/gatecli
Download Configuration Files:
# Download config.json
wget https://gatechainbucket.oss-cn-beijing.aliyuncs.com/config/config.json
# Download genesis.json
wget https://gatechainbucket.oss-cn-beijing.aliyuncs.com/config/genesis.json
Copy downloaded binaries to "/usr/local/bin":
cp gated gatecli /usr/local/bin
Create node root directory:
mkdir ~/.gated
Copy configuration files to "$GATEHOME/"
Starting the Node
Basic Start
gated start
Start with GC Mode
To start in GC mode, modify the start command:
gated start --pruning nothing
Start EVM RPC
gatecli evm rest-server --gm-websocket-port http://127.0.0.1:8085 --chain-id mainnet --laddr tcp://0.0.0.0:6060 --rpc-api web3,eth,personal,net,debug
For EVM RPC support, modify the following properties in config.json:
"WsPort": "tcp://0.0.0.0:8085"
"IsWebSocketServerActive": true
Save changes and restart gated.
Interact with a node
You can interact with your local node using either the gatecli command line interface or the RPC API.