Installation

The most common setup is to install MEV-Boost on the same machine as the beacon client. Multiple beacon clients can use a single MEV-Boost instance. The default port is 18550.

See also Rémy Roy's guide for comprehensive instructions on installing, configuring and running MEV-Boost.

Binaries

Each release includes binaries for Linux, Windows and macOS. You can find the latest release at:

https://github.com/flashbots/mev-boost/releases

1. Download the binary for your platform from the latest release
2. Make it executable: chmod +x mev-boost
3. Verify it works:

./mev-boost -help

From Source

Requires Go 1.18+.

Option A: go install

go install github.com/flashbots/mev-boost@latest
mev-boost -help

Option B: Clone and Build

git clone https://github.com/flashbots/mev-boost.git
cd mev-boost

# Use the stable branch (always the latest released version)
git checkout stable

# Or check out a specific release tag
# git checkout tags/YOUR_VERSION

# Build
make build

# Verify
./mev-boost -help

Docker

MEV-Boost Docker images are maintained at hub.docker.com/r/flashbots/mev-boost.

1. Install Docker Engine
2. Pull and run the latest image:

docker pull flashbots/mev-boost:latest

docker run flashbots/mev-boost -help

Run with relay configuration:

docker run flashbots/mev-boost \
    -mainnet \
    -relay-check \
    -relays YOUR_RELAY_URL

Systemd Service

Run MEV-Boost as a systemd service. Create /etc/systemd/system/mev-boost.service:

[Unit]
Description=mev-boost
Wants=network-online.target
After=network-online.target

[Service]
User=mev-boost
Group=mev-boost
WorkingDirectory=/home/mev-boost
Type=simple
Restart=always
RestartSec=5
ExecStart=/home/mev-boost/bin/mev-boost \
    -relay-check \
    -relay YOUR_RELAY_CHOICE_A \
    -relay YOUR_RELAY_CHOICE_B \
    -relay YOUR_RELAY_CHOICE_C

[Install]
WantedBy=multi-user.target

Then enable and start:

sudo systemctl daemon-reload
sudo systemctl enable mev-boost
sudo systemctl start mev-boost

Check the status:

sudo systemctl status mev-boost
sudo journalctl -u mev-boost -f