Swarm 2.0 BXX testnet node operation tutorial

3 min readJul 23, 2021


Starting Swarm 2.0 is very simple, a total of 4 steps are required:

  1. Preparation
  2. Download and modify configuration
  3. Start the node
  4. Get ETH & kBXX

Let’s get started!

Step1: Preparation

1. Register third-party RPC EndPoint

Recommend 2 websites that provide RPC service, choose one to register: https://infura.io/ https://alchemyapi.io/

After registering and logging in, copy the link of RPC EndPoint of its kovan (Ethereum Kovan Testnet) network, For example, the link address provided by infura https://kovan.infura.io/v3/b4f69e167caa4beba01902c01f358bdf.

Note: This link is used to modify the BEE_SWAP_ENDPOINT field of the subsequent configuration file .env file; If you need to build your own RPC EndPoint, please refer to here.

2. Download and install docker, docker-compose

The following takes the operating system as ubuntu and the machine’s CPU architecture as the amd64 architecture as an example for operation:

a) Run the following command to install docker

sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg 
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

b) Run the following command to install docker-compose

sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

If you are not the above operating system or CPU architecture, please refer to here to install: https://docs.docker.com/engine/install/

Step2: Download and modify configuration

a) Download configuration

curl 'https://raw.githubusercontent.com/swarm-bxx/bee-docs/main/docker-compose/docker-compose.yml' -o docker-compose.yml
curl 'https://raw.githubusercontent.com/swarm-bxx/bee-docs/main/docker-compose/.env' -o .env

b) Change setting

Using a text editor, open the .env file downloaded above. Modify the value of BEE_PASSWORD to your customized password; Modify the value of BEE_SWAP_ENDPOINT to the link you got from “Registering a third-party RPC EndPoint” in this document. Modify the BEE_P2P_ADDR field to your “public network ip:1634” and make sure its port (note that the docker-compose.yml in this tutorial will modify the port to 2634) is open.

Step3: Start node

Run the following command to start the node

sudo docker-compose up -d

If you need to view specific logs, please refer to the docker logs command description.

Step4: Get ETH & kBXX

View the wallet address and deposit address of the current node

docker ps -f "ancestor=swarmbxx/bee" -q |xargs docker logs

For example, the address in the log below (0x5476afb588c6ff9a186eb29a73f742a8a9c5419e, pay attention to adding 0x prefix) is the wallet address of the node:

time="2021-07-23T08:54:40Z" level=info msg="using ethereum address 5476afb588c6ff9a186eb29a73f742a8a9c5419e"

Visit here and enter your wallet address to get the ETH test currency required for startup. Visit Official Discord and enter the following command on the Faucet channel to receive the kBXX test coin.

/faucet <your ethereum address>

# Example:
/faucet 0x5476afb588c6ff9a186eb29a73f742a8a9c5419e

At this point, until the log no longer prompts the following information.

time="2021-07-23T08:54:41Z" level=warning msg="cannot continue until there is sufficient ETH (for Gas) and at least 50 BZZ available on 5476afb588c6ff9a186eb29a73f742a8a9c5419e"

At this point, our Swarm 2.0 BXX test network node is running smoothly :)

If you have any questions, you can discuss and ask for help in the Official Discord testnet channel.

Find us here:

Website: http://bxx.so/

GitHub: https://github.com/swarm-bxx

Discord: https://discord.gg/65c5wBtaeB

Medium: https://swarm-bxx.medium.com/

Telegram: https://t.me/Bxx_club

Twitter: https://twitter.com/BXX40404735

Whitepaper: http://bxx.so/files/Swarm2.0_whitepaper_v1.0.pdf




Swarm 2.0 is a decentralized storage and communication network based on P2P technology, dedicated to a license-free, self-sustaining scalable infrastructure