To update the components of the project, run from within the project
directory (cd ~/eth2-docker
by default):
git pull
cp .env .env.bak && cp default.env .env
- Adjust contents of new
.env
, use.env.bak
for guidance (LOCAL_UID and COMPOSE_FILE are the most common variables that may need to be adjusted) sudo docker-compose build --pull
if you are using binary builds, the defaultsudo docker-compose build --pull --no-cache beacon
only if you are using source builds, then runsudo docker-compose build -pull
to update the rest of the "stack"sudo docker-compose down
- !! If coming from Lighthouse v0.2.x, make changes as per notes for v0.1.6
- !! If coming from Prysm alpha.29 or earlier, make changes as per notes for v0.1.7
sudo docker-compose up -d eth2
- Lighthouse v1.0.1 validator metrics supported
- Support for Besu eth1 client
- Fixed an issue with Nimbus log file
- Removed CORS settings for eth1, for now
- Tightened hosts values for Geth and Besu
- Support for Lighthouse v1.0.0
- Change default tags for Lighthouse and Prysm to track v1.0.0 release
- Initial attempt at Besu integration. While Besu builds, Lighthouse doesn't communicate with it. Strictly for testing.
- Integrated community dashboard for lighthouse, teku, and nimbus.
- Nethermind added as eth1 option, thanks to adrienlac. Not stable in testing.
- First attempt at binary option for all but eth2.0-deposit-cli
- Added option to run eth1 node exposed to the host on RPC port
- Updated grafana image to change all occurrences of
job="beacon"
tojob=beacon_node
in the metanull dashboard. - Updated grafana image to rename prysm dashboard titles.
- Auto configure Grafana with prometheus datasource.
- Auto Add
Metanull's Prysm Dashboard JSON
to Grafana - Auto Add
Prysm Dashboard JSON
to Grafana - Auto Add
Prysm Dashboard JSON for more than 10 validators
to Grafana
- Add OpenEthereum eth1 client option
- Experimental Prysm slasher - thank you @danb!
- Fixed Prysm Grafana which got broken when pulling out Prysm Web
- eth2.0-deposit-cli 1.0.0 for Ethereum 2.0 main net
- First stab at Lighthouse voluntary exit
- More conservative build targets for Lighthouse, Prysm, Teku, and Geth: Latest release tag instead of
master
- validator-import for Teku now understands Prysm export
- Support experimental Prysm Web UI
- Prysm change to remove creation of new protection DB, Prysm no longer has this flag
- Prysm changes to allow creation of new protection DB and remove experimental web support while it is in flux
- Prysm renamed
accounts-v2
toaccounts
, keeping pace with it
- Added "validator-voluntary-exit" to Prysm, see readme
- Default restart policy is now "unless-stopped" and can be changed via
.env
- Preliminary work to support Prysm Web UI, not yet functional
- Changed testnet parameter for Prysm to conform with alpha.29
- Use
--blst
with Prysm by default for faster sync speed - Handles Terms Of Service for Prysm, user is prompted during validator-import, and choice is remembered
- If you are upgrading this project and you are using Prysm, please run
sudo docker-compose run validator
and accept the terms of use. You can then Ctrl-C that process and start up normally again. This step is not necessary if you are starting from scratch.
- Support for Lighthouse v0.3.0, drop support for v0.2.x
- Please note that Lighthouse v0.3.x makes a breaking change to the beacon
db. You will need to sync again from scratch, after building the new v0.3.0
beacon image. You can force this with
sudo docker-compose down
,sudo docker volume rm eth2-docker_lhbeacon-data
(adjust to your directory path if you are not ineth2-docker
, seesudo docker volume ls
for a list). - Likewise, the location of the validator keystore has changed. The fastest way
to resolve this involves importing the keystore from scratch:
sudo docker volume rm eth2-docker_lhvalidator-data
(as before, adjust for your directory), and then import the keystore(s) again withsudo docker-compose run validator-import
. Your keystore(s) need to be in.eth2/validator_keys
inside the project directory for that. - When you have completed the above steps, bring up Lighthouse with
sudo docker-compose up -d eth2
and verify that the beacon started syncing and the validator found its public key(s) by observing logs:
sudo docker-compose logs -f beacon
andsudo docker-compose logs validator | head -30
, and if you wish to see ongoing validator logs,sudo docker-compose logs -f validator
. - The beacon will sync from scratch, which will take about half a day. Your validator will be marked offline for that duration.
- Please note that Lighthouse v0.3.x makes a breaking change to the beacon
db. You will need to sync again from scratch, after building the new v0.3.0
beacon image. You can force this with