Releases: Consensys/teku
25.12.0
This is a recommended release update containing bug fixes and improvements.
Downloads
- Available as
25.12.0on Dockerhub - Download the binary distribution:
Additions and Improvements
- Added new metrics beacon_earliest_available_slot and data_column_sidecar_processing_validated_total.
- Block proposal duties can now be scheduled in advance for fulu.
- Late block reorg enabled by default.
- Block building preparation enabled by default. The beacon node will now pre-compute head and pre-state selection in preparation for block building. (Disabled in Gnosis).
- Enabled a new version of sidecar recovery by default.
Bug Fixes
- Fixed a storage issue which sometimes caused Teku to crash during shut down.
- Fixed peer_count metric when using --metrics-publish-endpoint feature.
- Fixed earliest_available_slot calculation.
Upcoming Breaking Changes
N/A
25.11.1
This is an optional update containing improvements and bug fixes.
Downloads
- Available as
25.11.1on Dockerhub - Download the binary distribution:
Breaking Changes
- jdk 24 docker image build has been removed in favour of jdk 25 docker image build.
Additions and Improvements
- Added connection direction to beacon_peer_count metric.
- Added metrics for outgoing LibP2P RPC requests (rpc_requests_total, rpc_requests_sent and rpc_requests_failed).
Bug Fixes
- Fixed NPE in DasPreSampler.
Upcoming Breaking Changes
N/A
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.