hopbitsDocs

↑ ↓ to moveEnter to openEsc to close

Sign inCreate account

Run a node

Before you start

What a node needs, what it does on your connection, and how it is kept in check.

On this page

What you need

  • A 64-bit Linux machine, x86_64 or ARM64. A Raspberry Pi, a NAS, a home server or a VPS all work.
  • Docker, installed and running.
  • A connection that stays on. The node only makes outgoing connections, so there is nothing to forward on your router.
  • A Hopbits account to pair the node with. Create one if you have not yet.

What it does on your connection

The node runs measurement jobs against public services: an HTTP request, a TCP connect or a ping. Measurement traffic is capped at 200 MB per UTC day, and you can set the cap lower.

How it runs

  • In a container with every Linux capability dropped and no way to gain new privileges.
  • As an unprivileged user, UID 65532.
  • With its identity in one Docker volume, hopbits-data.
  • It updates itself from signed releases. You can turn that off.

Next

Quick installOne command starts the node and prints its pairing code.OpenRun with DockerStart the container yourself, with the command line or with Compose.Open