Releases: Consensys/teku
25.11.0
Downloads
- Available as
25.11.0on Dockerhub - Download the binary distribution:
Breaking Changes
N/A
Additions and Improvements
- 🚀 Added mainnet configuration for the Fulu fork 🦓 due at epoch 411392, December 3, 2025, 09:49:11pm UTC
- Implemented
/eth/v1/beacon/states/{state_id}/proposer_lookaheadwhich will be accessible after the Fulu fork.
Bug Fixes
N/A
Upcoming Breaking Changes
N/A
25.10.0
This is an optional update for Mainnet. It is recommended for all Testnets.
Downloads
- Available as
25.10.0on Dockerhub - Download the binary distribution:
Breaking Changes
GOSSIP_MAX_SIZE,MAX_CHUNK_SIZE,TTFB_TIMEOUTandRESP_TIMEOUTconfiguration variables are no longer exported as they were removed from spec.
Any release compliant with fulu (fusaka) will not require these to be present, but earlier releases may no longer be able to consume this configuration.
Known Issues
- LevelDB may log errors during shutdown under some circumstances.
Additions and Improvements
- Add User-Agent header to requests initiated from the Validator Client with the client identifier and version.
- Increase Default validator registration Gas Limit 60M for all networks.
- Rename Fulu metric for data_column_sidecar_by_root RPC request to
network_rpc_data_column_sidecars_by_root_requested_sidecars_total. - Add peer count per topic metric for data_column_sidecar subnet.
- Add Get Blobs (
/eth/v1/beacon/blobs/{block_id}) Beacon API method.
Bug Fixes
N/A
Upcoming Breaking Changes
N/A
25.9.3
This is an optional update for Mainnet.
It is required only for Testnets affected by the upcoming Fulu forks.
Downloads
- Available as
25.9.3on Dockerhub - Download the binary distribution:
Breaking Changes
N/A
Additions and Improvements
- Added scheduling for Fulu testnets:
- Holesky fork at epoch 165120 (2025-10-01 08:48:00 UTC)
- Sepolia fork at epoch 272640 (2025-10-14 07:36:00 UTC)
- Hoodi fork at epoch 50688 (2025-10-28 18:53:12 UTC)
Bug Fixes
N/A
Upcoming Breaking Changes
GOSSIP_MAX_SIZE,MAX_CHUNK_SIZE,TTFB_TIMEOUTandRESP_TIMEOUTconfiguration variables will NOT be supported after the Fusaka Mainnet release. These variables should be removed from any custom network configs.
25.9.2
This is a hotfix release targeting an issue with 25.9.1. If you are a node operator running 25.9.1, it is highly recommended to upgrade. For all other operators, it is an optional upgrade.
Key Changes
- bug fix resolving a potential deadlock introduced with
25.9.1, causing the node to stall.
Downloads
- Available as
25.9.2on Dockerhub - Download the binary distribution:
Breaking Changes
N/A
Additions and Improvements
N/A
Bug Fixes
- bug fix resolving a potential deadlock introduced with 25.9.1, causing the node to stall.
Upcoming Breaking Changes
GOSSIP_MAX_SIZE,MAX_CHUNK_SIZE,TTFB_TIMEOUT, andRESP_TIMEOUTconfiguration variables will NOT be supported after the Fusaka Mainnet release. These variables should be removed from any custom network configs.
25.9.1
This is a hotfix release targeting an issue with 25.9.0.
We have identified an issue where Teku isn't able to follow the network after upgrading to 25.9.0. Further information is available at https://hackmd.io/@teku/B1lVi-Scxg. If you are on a Debian/Ubuntu system with Grafana installed, this is likely to affect you and you should upgrade to 25.9.1.
Key Changes
- Reverted snappy-java to the previous version to avoid incompatibility with some systems.
Downloads
- Available as
25.9.1on Dockerhub - Download the binary distribution:
Breaking Changes
N/A
Additions and Improvements
N/A
Bug Fixes
- Downgraded snappy library because of musl issue on some nodes.
Upcoming Breaking Changes
GOSSIP_MAX_SIZE,MAX_CHUNK_SIZE,TTFB_TIMEOUT, andRESP_TIMEOUTconfiguration variables will NOT be supported after the Fusaka Mainnet release. These variables should be removed from any custom network configs.
Read the changelog for 25.9.0 to see all new features and bug fixes added on 25.90: https://github.com/Consensys/teku/releases/tag/25.9.0
25.9.0
This is an optional update containing bug fixes and improvements.
KNOWN ISSUE
We have identified an issue where Teku isn't able to follow the network after upgrading to 25.9.0. Further information is available at https://hackmd.io/@teku/B1lVi-Scxg . If you are on a debian/ubuntu system with grafana installed, this is likely to affect you. Consider deferring installing until 25.9.1 is available.
If this issue does affect you, you should downgrade to 25.7.1 until 25.9.1 is available.
Downloads
- Available as
25.9.0on Dockerhub - Download the binary distribution:
Breaking Changes
N/A
Additions and Improvements
- Enabled, by default, a new attestation pool implementation that improves the attestation packing during block and aggregation production. It can still be disabled by setting
--Xaggregating-attestation-pool-v2-enabled=falseif needed - Added
--p2p-discovery-bootnodes-urlCLI option. - Updated
LUKSOconfiguration with Electra fork scheduled for epoch190800(September 17th, 2025, 16:20:00 UTC) - Avoid builder validator registration calls, potentially delaying block production builder calls.
- Removed
TTFB_TIMEOUTandRESP_TIMEOUTfrom the default network configurations in line with ethereum/consensus-specs#4532
Bug Fixes
- Limited the allowed time to wait for fork choice before proceeding with attestation duties, and added a development flag to adjust the timing if required.
- Allowed voluntary exits to be periodically re-broadcast if they have been submitted locally and they have been in the queue for a long time (2 hours).
Upcoming Breaking Changes
GOSSIP_MAX_SIZE,MAX_CHUNK_SIZE,TTFB_TIMEOUT, andRESP_TIMEOUTconfiguration variables will NOT be supported after the Fusaka Mainnet release. These variables should be removed from any custom network configs.
25.7.1
This is an optional update containing bug fixes and improvements.
Downloads
- Available as
25.7.1on Dockerhub - Download the binary distribution:
Breaking Changes
- Removed
--validators-proposer-blinded-blocks-enabledunused option. This option is not used anymore and should be removed from any config
Additions and Improvements
- Increase the default gas limit (
--validators-builder-registration-default-gas-limit) to 45 million
Bug Fixes
- Fix a regression introduced in the previous release causing a validator client configured with sentry nodes to not work properly
Upcoming Breaking Changes
N/A
25.6.0
This release introduced a regression on validator clients using a sentry configuration (sentry-config-file).
Roll back to 25.5.0 if you are affected.
This is a recommended update containing bug fixes and performance improvements.
Downloads
- Available as
25.6.0on Dockerhub - Download the binary distribution:
Breaking Changes
- Previous versions of Teku will not be able to read the configuration from this version of Teku (including VC) due to the defaulting of BPO configuration to an empty list.
Additions and Improvements
- Added
/eth/v1/beacon/states/{state_id}/validator_identitiesendpoint to allow querying of validator identities. - Several improvements on how validator client handles multiple beacon nodes:
- reduced timeout for beacon node API calls down to 10 seconds
- improved handling of unresponsive\unreachable beacon nodes.
- dedicated thread pools for beacon node API calls
Bug Fixes
- Fixed validator client missing duties when secondary beacon nodes are not responsive. Happens only for validator clients configured with multiple
--beacon-node-api-endpoints.
Upcoming Breaking Changes
- The
--validators-proposer-blinded-blocks-enabledis deprecated and will be removed. It's not used anymore and should be removed from any configs.
25.5.0
This is a recommended update containing bug fixes and performance improvements.
Downloads
- Available as
25.5.0on Dockerhub - Download the binary distribution:
Breaking Changes
- Previous versions of Teku will not be able to read the configuration from this version of Teku (including VC) due to the addition of BPO configuration.
Additions and Improvements
- Added
--p2p-static-peers-urloption to read static peers from a URL or file - Added node epoch and computed slot to the sync committee duties failure message for more context about the failure condition.
- Updated third-party libraries.
- Added an info message on startup for the highest supported milestone and associated epoch.
- Added JDK 24 docker image build.
- Reduced block building time at the first slot of an epoch when a large number of validators are configured.
- Improved configuration loading to utilise built-in configurations and default any necessary fields that were missing from a passed-in configuration.
- Added
/teku/v1/admin/add_peerendpoint to allow adding static peers via the REST API.
Bug Fixes
- Added an error if the genesis state has invalid data in its latest block header.
Upcoming Breaking Changes
N/A
25.4.1
This is a required update for Mainnet, Gnosis, and all electra enabled networks.
Mainnet Electra activation will happen at epoch 364032 (May 7, 2025, 10:05:11am UTC).
Gnosis Electra activation will happen at epoch 1337856 (April 30, 2025, 14:03:40 UTC).
Downloads
- Available as
25.4.1on Dockerhub - Download the binary distribution:
Breaking Changes
- It is no longer possible to set both
--checkpoint-sync-urland--initial-state. If your node fails to start after upgrade, ensure that only one of these is set.
Additions and Improvements
- Updated Teku bootnode ENR on Sepolia and Mainnet
- Scheduled Electra for Mainnet at epoch 364032 (May 7, 2025, 10:05:11am UTC)
- Scheduled Electra for Gnosis at epoch 1337856 (April 30, 2025, 14:03:40 UTC)
- Third party library updates.
Bug Fixes
- It is no longer possible to set both
--checkpoint-sync-urland--initial-state. - Aggregating attestations using DVT does not cause missed aggregations when multiple validators are
scheduled for the same slot #9347.
Upcoming Breaking Changes
N/A