Practical overview
When it fits
Use it when running an Ethereum MEV-Boost relay or designing a proposer or builder integration that communicates through one.
Who it is for
- Operators deploying Ethereum MEV-Boost relay infrastructure
- Developers integrating proposer or builder systems with a relay
- Teams evaluating the relay’s dependencies and beacon-client requirements
Documented uses
- Operate a relay connecting Ethereum block builders and proposers
- Serve proposer, builder and data APIs
- Maintain known-validator and proposer-duty information through a background service
- Review documented local Sepolia service setup and integration references
Requirements & limits
The project source is a public GitHub repository under the AGPL-3.0 license.
- PostgreSQL, Redis, beacon nodes and block-submission validation nodes are listed dependencies; Memcached is optional.
- The README strongly advises multiple beacon nodes because local validation and broadcast affect whether a block is returned to the proposer.
- Beacon-node event support and block-publishing requirements vary across the current main branch and the v0.26 release.
- The API, website and housekeeper are separate services designed to run and scale independently.
- The repository links to relay API specifications and Docker images.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start the documented Sepolia services locally
Run the repository’s example housekeeper, API and website services against PostgreSQL and Redis for Sepolia.
Before you start
- Go environment capable of running the repository
- PostgreSQL and Redis; the README also documents Docker-based startup
- A beacon-node setup for relay operation; the README separately details client requirements and version caveats
Steps
Start PostgreSQL and Redis individually with the documented Docker commands, or use the repository’s docker-compose setup.
Run the housekeeper using the README’s Sepolia command and PostgreSQL connection string.
Run the API using the documented Sepolia command, dummy BLS secret key and database connection string.
Run the website using the documented Sepolia command and database connection string.
Expected outcome
The three documented service processes are started for Sepolia; the README provides a status-query example for the API.
Guide limitations
- The example commands are a local setup recipe, not evidence of a successful run or a production deployment.
- Relay operation also depends on beacon nodes and block-submission validation nodes; the README warns that beacon-client support differs by branch and release.
- The example uses a dummy BLS secret key.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- flashbots/mev-boost-relay · Official homepage title · retained in its source language

