Run a node

Enrol a fleet

An enrolment token lets several nodes join your account without pairing each one by hand.

On this page

Create a token
Use it with the installer
Use it with Docker

Create a token

In the operator dashboard, find the enrolment tokens. Give the token a label, choose how many nodes it may enrol, and press Generate token.

A token works for 24 hours.
One token can enrol up to 10 nodes.
It is shown once. Copy it when it appears.
You can revoke it in the same table.

Use it with the installer

Linux shell

curl -fsSL https://hopbits.io/install.sh | HOPBITS_ENROLL='YOUR_TOKEN' sudo -E sh

The installer stores the token in /etc/hopbits/agent.env, which only root can read, and hands it to the container from there.

Use it with Docker

Keep the token in a file that only root can read, and pass the file to the container:

Docker CLI

sudo docker build -t hopbits/agent:local https://hopbits.io/releases/Dockerfile
sudo docker volume create hopbits-data

sudo mkdir -p /etc/hopbits
echo "HOPBITS_ENROLL=YOUR_TOKEN" | sudo tee /etc/hopbits/agent.env > /dev/null
sudo chmod 600 /etc/hopbits/agent.env

sudo docker run -d \
  --name hopbits-agent \
  --restart=always \
  --cap-drop ALL \
  --security-opt no-new-privileges:true \
  --network host \
  -e HOPBITS_NETWORK_MODE=host \
  --env-file /etc/hopbits/agent.env \
  -v hopbits-data:/var/lib/hopbits \
  hopbits/agent:local