Skip to content

Beacon node

This page takes you through the steps of getting a standard installation of the Nimbus beacon node running.

The quickstart setup involves running two nodes: an execution client and a beacon node. Both are needed to run a full Ethereum setup.

To become a validator, you first need to set up a beacon node. The beacon node connects to the beacon chain network, syncs historical data, and provides API's to monitor and interact with the beacon chain. Running a beacon node is a worthwhile endeavor even if you are not planning on validating yourself!

The guide assumes Ubuntu Linux is being used, and therefore some familiarity with the Linux command line is needed.

Tip

You can practice running the node safely on the Holesky testnet. Throughout, we'll provide instructions for both Holesky and Mainnet.

Steps

1. Prepare

Prepare your machine by installing Nimbus' dependencies.

2. Set up an execution client

To run a beacon node, you need to have access to an execution client exposing the web3 API. Throughout, we'll assume an execution client is running on the same machine as the beacon node, but this is not required.

See the execution client guide for instructions on how to pick and install an execution client.

3. Install Nimbus

Binary releases are available from GitHub and our APT repository (Debian/Ubuntu).

We currently have binaries available for Linux AMD64, ARM and ARM64, Windows AMD64 and macOS (AMD64 and ARM64).

See the binaries guide on how to install them.

Building Nimbus from source is simple and fully automated. Follow the build guide.

4. Sync from a trusted node

While this step is not mandatory, since Nimbus will automatically start syncing process on the first start, we recommend doing it as it will allow you to get started in minutes instead of hours or even days.

Follow our trusted node sync guide.

5. Start the node

Once you've completed previous steps, it is time to start the beacon node.

If you have skipped the syncing from a trusted node step, starting the node will initiate the syncing process.

cd nimbus-eth2
# Start a mainnet node
./run-mainnet-beacon-node.sh --web3-url=http://127.0.0.1:8551 --jwt-secret=/tmp/jwtsecret
# Start a holesky testnet node
./run-holesky-beacon-node.sh --web3-url=http://127.0.0.1:8551 --jwt-secret=/tmp/jwtsecret

Once the beacon node starts, you'll see it logging information to the console, like so:

INF 2022-07-19 15:42:58.145+02:00 Launching beacon node                      topics="beacnde" version=v22.10.1-97a1cdc4-stateofus ...

Congratulations! Your beacon node is up and running!

What next?

  • If you will be running the node on a regular basis, it is recommended that you set up a systemd service that automatically restarts your node if the computer reboots.
  • If you wish to stake, continue your journey by following the validator quick start.
  • The monitoring page contains information about how to keep your node healthy.