Skip to main content
Run a node

Run a Linea node

Linea follows Ethereum’s dual-layer design. Every Linea node runs:

  • Maru for consensus
  • An execution layer client of your choice

The following table lists the clients covered in this guide, and whether they provide direct access to Linea-specific features.

NameDescriptionRuns Linea-specific features?
BesuAn Java-based open-source Ethereum client that can be extended using plugins.
Linea BesuBesu client with plugins that implement Linea-specific features, such as API methods and a finalized tag.
GethThe most widely used open-source Ethereum client, written in Go.
ErigonA Go-based Ethereum client focused on performance and saving disk space. Until a published Erigon v3.5 or later image is available, build the image from the Linea support merge commit.

Docker Compose quickstart

Docker Compose is the recommended method to run a node. For binaries or build-from-source and client-specific instructions, see the individual guides, or keep reading for a general guide.

Use Docker Compose as the default path. The canonical compose files live in the Linea monorepo:

Quick steps:

  1. Pick your network (mainnet or Linea Sepolia) and download the compose file above.
  2. From that directory, run Docker Compose to start Maru plus your execution client.
  3. For Linea-specific APIs such as linea_estimateGas and the finalized tag, use the Linea Besu compose example.

Next actions:

  • Default compose examples: Linea Besu and Maru.
  • Alternative EL clients: Besu, Geth, or Erigon to follow the chain. Erigon currently requires a locally built image until a published Erigon v3.5 or later release is available.
  • Upgrades: see upgrade guides.
  • Bootnodes: see bootnodes if you need to override defaults.

Canonical sources

  • Compose files in the Linea monorepo (paths above) are the source of truth for images and versions.
  • Linea Besu (basic and advanced profiles): use the linea-besu/package/docker compose profiles.
  • All other execution layer clients (Besu, Geth, etc.): use the compose files under docs/getting-started/.

Alternative paths

Binaries or build-from-source are supported. Each client page documents its binary path as an alternative if Docker Compose does not fit your environment.

There are no financial incentives for running a Linea node, and there is currently no option to vote on blocks as part of the consensus mechanism or fork-choice like on Ethereum.

Was this page helpful?