Skip to content

fix: default CLIENT to reth in docker-compose.yml#1034

Open
erhnysr wants to merge 1 commit intobase:mainfrom
erhnysr:fix/default-client-reth
Open

fix: default CLIENT to reth in docker-compose.yml#1034
erhnysr wants to merge 1 commit intobase:mainfrom
erhnysr:fix/default-client-reth

Conversation

@erhnysr
Copy link
Copy Markdown

@erhnysr erhnysr commented Apr 26, 2026

Problem

README.md documents reth as the default execution client:

  • reth (default)

But docker-compose.yml uses geth as the fallback:

dockerfile: ${CLIENT:-geth}/Dockerfile

Running docker compose up without setting CLIENT silently starts geth instead of reth. This contradicts the documented default and, more critically, increases the risk of operators missing the Base V1 migration — after V1 activates (early May 2026), only base-reth-node will follow the canonical chain.

Fix

Change the CLIENT fallback from geth to reth in both service definitions in docker-compose.yml. Operators who intentionally run geth can still do so by setting CLIENT=geth explicitly in their env file.

Impact

Fixes #1010

README.md already documents reth as the default execution client, but
docker-compose.yml used geth as the fallback value for the CLIENT
variable. This meant that running docker compose up without explicitly
setting CLIENT=reth would silently start geth instead of reth.

After Base V1 activates (early May 2026), only base-reth-node supports
the network. Having geth as the implicit default increases the risk of
operators missing the migration.

Changed the CLIENT fallback from geth to reth in both the execution and
node service Dockerfile references so the default behaviour matches the
documented default and the post-V1 requirement.

Operators who intentionally run geth can still do so by setting
CLIENT=geth explicitly in their env file.

Fixes base#1010.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README says reth is the default client but docker-compose.yml defaults to geth

1 participant