NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #1326 by repository stars
Latest stable
v0.40.1
Last release 20 days ago
02 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 57 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
1185 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Add Controller interface by @FZambia in https://github.com/centrifugal/centrifuge/pull/467 - cross-node communication may be not a part of Broker now
Controller interface by @FZambia in https://github.com/centrifugal/centrifuge/pull/467 - cross-node communication may be not a part of Broker nowconcurrent map iteration and write panic by @FZambia in https://github.com/centrifugal/centrifuge/pull/473 - the panic could happen during issues with RedisFlushLatestPublication option for ChannelBatchConfig by @FZambia in https://github.com/centrifugal/centrifuge/pull/471 - this is nice to save bandwidth in channels where the loss of intermediary messages is acceptable and beneficialPublicationbase64.StdEncoding.AppendEncode in encodeAcceptKey by @FZambia in https://github.com/centrifugal/centrifuge/pull/481 - simplifies code a bit by using a new helper from Go std lib.❯ gorelease -base v0.35.0 -version v0.36.0
# github.com/centrifugal/centrifuge
## incompatible changes
(*MemoryBroker).PublishControl: removed
(*MemoryBroker).Run: removed
(*RedisBroker).Run: removed
Broker.PublishControl: removed
Broker.RegisterBrokerEventHandler: added
Broker.Run: removed
BrokerEventHandler.HandleControl: removed
## compatible changes
(*MemoryBroker).RegisterBrokerEventHandler: added
(*Node).SetController: added
(*RedisBroker).RegisterBrokerEventHandler: added
(*RedisBroker).RegisterControlEventHandler: added
ChannelBatchConfig.FlushLatestPublication: added
Config.ClientTimerScheduler: added
ControlEventHandler: added
Controller: added
PublishOptions.Version: added
PublishOptions.VersionEpoch: added
TimerCanceler: added
TimerScheduler: added
WithVersion: added
# summary
v0.36.0 is a valid semantic version for this release.
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.35.0...v0.36.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Support rediss:// scheme in Redis address and autodetect Redis Cluster by @FZambia in https://github.com/centrifugal/centrifuge/pull/463. Modern cloud
rediss:// scheme in Redis address and autodetect Redis Cluster by @FZambia in https://github.com/centrifugal/centrifuge/pull/463. Modern cloud providers usually provide redis://host:port or rediss://host:port URLs to users, which may correspond to either standalone Redis or Redis Cluster under the hood. Things should now work out of the box for Centrifuge users when using this string as the Redis address, making Centrifuge Redis Broker more cloud-friendly.❯ gorelease -base v0.34.4 -version v0.35.0
# github.com/centrifugal/centrifuge
## compatible changes
ChannelBatchConfig: added
Config.GetChannelBatchConfig: added
# summary
v0.35.0 is a valid semantic version for this release.
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.34.4...v0.35.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Cache preflight requests by @FZambia in https://github.com/centrifugal/centrifuge/pull/461 - this allows to reduce number of preflight requests in cro
http.ResponseController usage in emulation transportsFull Changelog: https://github.com/centrifugal/centrifuge/compare/v0.34.3...v0.34.4
Nothing published for this version
Nothing published for this version
Unidirectional transports: optimizations and delta encoding support enabler by @FZambia in https://github.com/centrifugal/centrifuge/pull/459
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.34.2...v0.34.3
❯ gorelease -base v0.34.2 -version v0.34.3
# github.com/centrifugal/centrifuge
## compatible changes
(*Client).ProtocolConnect: added
(*Client).ProtocolConnectNoErrorToDisconnect: added
ConnectRequest.Headers: added
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Use errors.As for disconnect extraction by @FZambia in https://github.com/centrifugal/centrifuge/pull/454
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.34.1...v0.34.2
Only aggregate centrifuge metrics by @FZambia in https://github.com/centrifugal/centrifuge/pull/453. Also resolves panic in Eagle library reported in
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.34.0...v0.34.1
That's why a new release of Centrifuge contains notable improvements, new features and some breaking changes (nothing dramatic, should be super-simple…
Centrifuge v0.34.0 aimed to be the base for Centrifugo v6 which was recently released. That's why a new release of Centrifuge contains notable improvements, new features and some breaking changes (nothing dramatic, should be super-simple to adopt, marked with ⚠️ below).
Support for sharded PUB/SUB in Redis Cluster. Please carefully read a comment for RedisBrokerConfig.NumShardedPubSubPartitions – the feature, while can be a great performance booster in Redis Cluster, may be really niche at the same time since it does not come for free and requires careful consideration before enabling.
The thing is that it reduces the number of shards in Redis Cluster to NumShardedPubSubPartitions number, and maintains a separate connection with each partition for effective PUB/SUB and guarantee that Centrifuge properly works with Redis Cluster shards.
See also addition discussion in issues/228 and information in Centrifugo release post.
It's now possible to utilize Redis replicas in Redis cluster and Redis Sentinel setups to delegate channel subscriptions to them and delegate reading presence to them. To enable use RedisShardConfig.ReplicaClientEnabled and RedisBrokerConfig.SubscribeOnReplica/RedisPresenceManagerConfig.ReadFromReplica options.
Using replicas may help you staying on lower resources if you already have HA Redis setup!
Possibility to use Redis address with special schemes redis+cluster:// and redis+sentinel:// so that it's now possible to fully configure any Redis configuration by using a single string.
Examples for single Redis, Redis Cluster, Redis Sentinel:
redis://user:password@127.0.0.1:6379/0
redis+cluster://127.0.0.1:7000
redis+sentinel://localhost:26379?sentinel_master_name=mymaster
Now channel namespace resolution of metrics (achievable using GetChannelNamespaceLabel func) works for all metrics related to channels. Internally we added Centrifuge-level cache to speed up getting the channel namespace label, but still please keep GetChannelNamespaceLabel fast since Centrifuge cache expires from time to time.
⚠️ Options ChannelNamespaceLabelForTransportMessagesReceived and ChannelNamespaceLabelForTransportMessagesSent were removed to simplify channel namespace resolution configuration – it will just work for all metrics once GetChannelNamespaceLabel func provided in the configuration.
New Redis benchmark tool allows to put Centrifuge specific load on Redis setup.
Centrifuge now has headers emulation support. See ConnectEvent.Headers.
In Centrifugo v6 this field is used to transfer headers natively in proxy requests to the backend, but when using Centrifuge library it's up to developer to decide how to use the headers map.
Added a bunch of new useful metrics. Like client connections inflight and client subscriptions inflight. Those may give you great observability insights previously missing.
⚠️ Centrifuge now moved metrics related metrics to MetricsConfig struct, it may require developer to update how Centrifuge config is created.
prometheus.RegistererGathererRedisBrokerConfig.Name to distinguish log entries when multiple brokers are used.❯ gorelease -base v0.33.6 -version v0.34.0
# github.com/centrifugal/centrifuge
## incompatible changes
(*Node).Log: removed
(*Node).LogEnabled: removed
Config.ChannelNamespaceLabelForTransportMessagesReceived: removed
Config.ChannelNamespaceLabelForTransportMessagesSent: removed
Config.GetChannelNamespaceLabel: removed
Config.MetricsNamespace: removed
NewLogEntry: removed
## compatible changes
Config.Metrics: added
ConnectEvent.Headers: added
LogEntry.Error: added
MetricsConfig: added
RedisBrokerConfig.Name: added
RedisBrokerConfig.NumShardedPubSubPartitions: added
RedisBrokerConfig.SubscribeOnReplica: added
RedisPresenceManagerConfig.ReadFromReplica: added
RedisShardConfig.ReplicaClientEnabled: added
RegistererGatherer: added
# summary
v0.34.0 is a valid semantic version for this release.
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.33.6...v0.34.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update to rueidis v1.0.52 by @FZambia in https://github.com/centrifugal/centrifuge/pull/443
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.33.5...v0.33.6
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix a deadlock during pub/sub and recovery sync by @FZambia in https://github.com/centrifugal/centrifuge/pull/439
DisconnectServerError cases by @FZambia in https://github.com/centrifugal/centrifuge/pull/417❯ gorelease -base v0.33.4 -version v0.33.5
# github.com/centrifugal/centrifuge
## incompatible changes
CommandProcessedEvent.Disconnect: removed
## compatible changes
(*Client).ConnectNoErrorToDisconnect: added
CommandProcessedEvent.Error: added
Config.UnidirectionalCodeToDisconnect: added
# summary
v0.33.5 is a valid semantic version for this release.
Full Changelog: https://github.com/centrifugal/centrifuge/compare/v0.33.4...v0.33.5
Nothing published for this version
One column per quarter.