Node Setup

Biturbo Test Node Documents

Biturbo Test Node Documentation

1. Hardware Requirements

• CPU: 4 Cores (or dual-core hyperthreaded)

• Memory: 16GB RAM

• Storage: 1TB SSD/HDD

• Network: At least 20Mb download speed

2. Start a Test Node with Docker

You can easily run a test node using Docker. The following bash command will help you set it up. In the container, the HTTP port is 8547 and the WS port is 8546. You can bind your preferred ports to the host machine.

# pull docker image
docker pull biturbonetwork/biturbo-testnet-node:0.1.2
# run test-node
# docker run -d -p ${HOST_HTTP_PORT}:8547 -p ${HOST_WS_PORT}:8546 -p 30303:30303 biturbonetwork/biturbo-testnet-node:<latest_version>
docker run -d -p 8547:8547 -p 8546:8546 -p 30303:30303 biturbonetwork/biturbo-testnet-node:0.1.2

3. Docker Environment Variables

You can customize some environment variables as follows. The default address is 0.0.0.0, meaning there are no restrictions on the access address of the Docker container. If necessary, specify network policies on the host machine.

Environment Variable	Description
HTTP_ADDR	HTTP-RPC server listening interface (default: "0.0.0.0")
WS_ADDR	WS-RPC server listening interface (default: "0.0.0.0")
SYNC_MODE	Sync mode ( "full") (default: "full". Testnet-node only support "full")
GC_MODE	Garbage collection mode ("full", "archive") (default: "archive")
LOG_LEVEL	Logging verbosity. ("silent", "error", "info", "debug", " detail") (default: "error")

4. RPC Addresses

In the container, the HTTP port is 8547 and the WS port is 8546. You can bind your preferred ports when starting the Docker container.

• HTTP Address: http://127.0.0.1:8547

• WS Address: ws://127.0.0.1:8546

5. Docker Compose

Using Docker Compose makes it easier to start services. Below is a docker-compose.yml file for reference:

version: '3'
services:
  testnet-node:
    image: biturbonetwork/biturbo-testnet-node:0.1.2
    ports:
      - "30304:30303"
      - "18547:8547"
      - "18546:8546"
    # Environment variables have default values. You can skip this part if there are no changes.
    environment:
      SYNC_NODE: 'full'
      GC_NODE: 'archive'
      LOG_LEVEL: 'error'
    # volumes is optional
    volumes:
      - /data/chaindata/data:/data/chaindata/data

This setup will help you quickly and efficiently run a Biturbo test node. If you have any questions or need further assistance, please refer to our support documentation or contact us directly.