Skip to content

fix: replace deprecated docker-compose with docker compose v2 in node setup guide #1298

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
erhnysr wants to merge 2 commits into
base: master
Choose a base branch
from
Open

fix: replace deprecated docker-compose with docker compose v2 in node setup guide #1298

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
83ce90f
docs: add RPC usage clarification note
erhnysr Apr 6, 2026
e9ab3e9
fix: replace deprecated docker-compose with docker compose v2 and upd…
erhnysr Apr 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -164,3 +164,6 @@ The core team will review opened PRs. The SLA is 2 weeks, generally on a first-c
## Storybook for UI components

See `storybook/README.md` for details on local Storybook and component docs.
## Additional Note

When building on Base, always ensure that you are using the correct RPC endpoint for the intended network (mainnet or testnet). Misconfiguration can lead to failed transactions or unexpected behavior.
10 changes: 5 additions & 5 deletions docs/base-chain/node-operators/run-a-base-node.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Run a Node
description: A tutorial that teaches how to set up and run a Base Node.
---

This tutorial will walk you through setting up your own [Base Node](https://github.com/base-org/node).
This tutorial will walk you through setting up your own [Base Node](https://github.com/base/node).

## Objectives

Expand Down Expand Up @@ -66,9 +66,9 @@ You'll need your own L1 RPC URL. This can be one that you run yourself, or via a

## Running a Node

1. Clone the [repo](https://github.com/base-org/node).
2. Ensure you have an Ethereum L1 full node RPC available (not Base), and set `OP_NODE_L1_ETH_RPC` & `OP_NODE_L1_BEACON` (in the `.env.*` file if using `docker-compose`). If running your own L1 node, it needs to be synced before Base will be able to fully sync.
3. Uncomment the line relevant to your network (`.env.sepolia`, or `.env.mainnet`) under the 2 `env_file` keys in `docker-compose.yml`.
1. Clone the [repo](https://github.com/base/node).
2. Ensure you have an Ethereum L1 full node RPC available (not Base), and set `OP_NODE_L1_ETH_RPC` & `OP_NODE_L1_BEACON` (in the `.env.*` file if using `docker compose`). If running your own L1 node, it needs to be synced before Base will be able to fully sync.
3. Uncomment the line relevant to your network (`.env.sepolia`, or `.env.mainnet`) under the 2 `env_file` keys in `docker-compose.yml` (Docker Compose v2).
4. Run `docker compose up`. Confirm you get a response from:

```bash Terminal
Expand Down Expand Up @@ -112,7 +112,7 @@ Once your node is synced, you can enable Flashblocks to serve 200ms preconfirmat
To enable Flashblocks, start your node with the following environment variables:

```sh
NODE_TYPE=base CLIENT=reth RETH_FB_WEBSOCKET_URL="wss://mainnet.flashblocks.base.org/ws" docker-compose up
NODE_TYPE=base CLIENT=reth RETH_FB_WEBSOCKET_URL="wss://mainnet.flashblocks.base.org/ws" docker compose up
```

| Variable | Description | Values |
Expand Down