Releases: Consensys/teku
26.2.0
This is a recommended update containing improvements and bug fixes.
RocksDB migration: The new default database system used by Teku is RocksDB. Existing LevelDB databases will not migrate automatically to RocksDB.
To migrate from LevelDB to RocksDB, you need to stop your Teku service and delete both the db directory and db.version file from your beacon node data directory.
Upon restart, your node will recreate the database using RocksDB.
Important: Before migrating, ensure you have --checkpoint-sync-url or --initial-state configured. Without one of these, Teku will fail to start after the database is deleted.
For more information regarding the incident that affected LevelDB nodes check this link.
Checkpoint syncing nodes: This release includes a new data columns sidecar backfiller. If you experience high CPU usage affecting validator duty performance, you can:
- Reduce the backfill batch size (default: 3) by setting
--Xp2p-reworked-sidecar-custody-sync-batch-size=1 - Make sure
--p2p-peer-upper-boundis not set too high (default: 100)
Downloads
- Available as
26.2.0on Dockerhub - Download the binary distribution:
Breaking Changes
- Removed development cli arg
--Xp2p-reworked-sidecar-recovery-enabled.
Additions and Improvements
- Using RocksDB as the default for new databases (previous databases using LevelDB will not be migrated automatically).
- New data columns sidecar backfiller enabled. It improves how the beacon node downloads past blobs related data it needs to custody.
- New CLI flag
--rest-api-getblobs-sidecars-download-enabledallows the beacon node to servegetBlobsREST API responses by attempting to fetch missing blob sidecars from the p2p network. The new flag--rest-api-getblobs-sidecars-download-timeoutcontrols the network fetch timeout (default: 5 seconds). - New CLI flag
--force-clear-dbto remove the beacon database on startup.
Bug Fixes
- Added
DOMAIN_BLS_TO_EXECUTION_CHANGEto spec api output.
Upcoming Breaking Changes
N/A
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