All Versions
66
Latest Version
Avg Release Cycle
35 days
Latest Release
23 days ago

Changelog History
Page 1

  • v2.7.2

    October 02, 2020

    No backwards incompatible changes here.

    ๐Ÿ›  Fixes:

    • Fix client reconnects due to InsufficientState errors. There were two scenarios when this could happen. The first one is using Redis engine with seq/gen legacy fields (i.e. not using v3_use_offset option). The second when publishing a lot of messages in parallel with Memory engine. Both scenarios should be fixed now.
    • ๐Ÿ›  Fix non-working SockJS transport close with custom disconnect code: this is a regression introduced by v2.6.2

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.7.2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.7
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.7.1

    September 24, 2020

    No backwards incompatible changes here.

    ๐Ÿ›  Fixes:

    • ๐Ÿ›  Fix non-working websocket close with custom disconnect code: this is a regression introduced by v2.6.2

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.7.1
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.7
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.7.0

    September 19, 2020

    ๐Ÿš€ This release has minor backwards incompatible changes in some Prometheus/Graphite metric names. This means that you may need to adapt your monitoring dashboards a bit. See details below.

    ๐Ÿ‘Œ Improvements:

    • ๐Ÿ‘€ Previously metrics exposed by Centrifuge library (which Centrifugo is built on top of) belonged to centrifuge Prometheus namespace. This lead to a situation where part of Centrifugo metrics belonged to centrifugo and part to centrifuge Prometheus namespaces. Starting from v2.7.0 Centrifuge library specific metrics also belong to centrifugo namespace. So the rule to migrate is simple: if see centrifuge word in a metric name โ€“ change it to centrifugo.
    • ๐ŸŒ Refreshed login screen of admin web interface with moving Centrifugo logo on canvas โ€“ just check it out!
    • ๐Ÿ†• New gauge that shows amount of running Centrifugo nodes
    • ๐Ÿฑ Centrifugal organization just got the first baker on Opencollective โค๏ธ. This is a nice first step in making Centrifugo development sustainable.

    ๐Ÿ›  Fixes:

    • Fix messages_sent_count counter which did not show control, join and leave messages

    ๐Ÿฑ Coming soon ๐Ÿ”ฅ:

    • Official Grafana Dashboard for Prometheus storage is on its way to Centrifugo users. Track this issue for a status, the work almost finished.
    • Official Centrifugo Helm Chart for Kubernetes. Track this issue for a status, the work almost finished.

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.7.0
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.7
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.6.2

    August 29, 2020

    No backwards incompatible changes here.

    ๐Ÿ‘Œ Improvements:

    • โ™ป๏ธ Internal refactoring of WebSocket graceful close, should make things a bit more performant (though only in apps which read lots of messages from WebSocket connections)
    • Disconnect code is now uint32 internally
    • A bit more performant permission checks for publish, history and presence ops
    • โšก๏ธ Connect proxy request payload can optionally contain name and version of client if set on client side, see updated connect proxy docs
    • ๐ŸŒ New blog post Experimenting with QUIC and WebTransport in Go in Centrifugo blog

    ๐Ÿ›  Fixes:

    • ๐Ÿ›  fix panic on connect in 32-bit ARM builds, see #387

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.6.2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.6
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.6.1

    August 07, 2020

    No backwards incompatible changes here.

    ๐Ÿ‘Œ Improvements:

    • Add grpc_api_key option, see in docs

    ๐Ÿ›  Fixes:

    • ๐Ÿ›  Fix Redis Engine errors related to missing epoch in Redis HASH. If you see errors in servers logs, like wrong Redis reply epoch or redigo: nil returned, then those should be fixed here. Also take a look at v2.5.2 release which contains backport of this fix if you are on v2.5.x release branch.

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.6.1
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.6
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.6.0

    July 19, 2020

    No backwards incompatible changes here.

    ๐Ÿ‘Œ Improvements:

    ๐Ÿš€ This release based on massively updated Centrifuge library, we don't expect problems but since many things were refactored โ€“ we suggest to carefully test your app.

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.6.0
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.6
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.5.2

    August 07, 2020

    ๐Ÿ›  Fixes:

    • Backport Redis Engine epoch fix from v2.6.1

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.5.2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.5
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.5.1

    May 19, 2020

    No backwards incompatible changes here.

    ๐Ÿ‘Œ Improvements:

    • ๐Ÿ“š refreshed documentation design
    • ๐Ÿ†• new Quick start chapter for those who just start working with Centrifugo
    • ๐Ÿš€ faster marshal of disconnect messages into close frame texts, significantly reduces amount of memory allocations during server graceful shutdown in deployments with many connections
    • one beautiful Centrifugo integration with Symfony framework from our community - check it out

    ๐Ÿ›  Fixes:

    • โž• add Content-Type: application/json header to outgoing HTTP proxy requests to app backend for better integration with some frameworks. #368
    • ๐Ÿ›  fix wrong channel name in Join messages sent to client in case of server-side subscription to many channels
    • ๐Ÿ›  fix disconnect code unmarshalling after receiving response from HTTP proxy requests, it was ignored previously

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.5.1
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.5
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.5.0

    May 11, 2020

    No backwards incompatible changes here.

    ๐Ÿš€ Starting from this release we begin migration to new offset uint64 client-server protocol field for Publication position inside history stream instead of currently used seq and gen (both uint32) fields. This offset field will be used in Centrifugo v3 by default. This change required to simplify working with history API, and due to this change history API can be later extended with pagination features.

    ๐Ÿ‘‰ Our client libraries centrifuge-js, centrifuge-go and centrifuge-mobile were updated to support offset field. If you are using these libraries then you can update centrifuge-js to at least 2.6.0, centrifuge-go to at least 0.5.0 and centrifuge-mobile to at least 0.5.0 to work with the newest client-server protocol. As soon as you upgraded mentioned libraries you can enable offset support without waiting for Centrifugo v3 release with v3_use_offset option:

    { ..."v3\_use\_offset": true}
    

    ๐Ÿ‘ All other client libraries except centrifuge-js, centrifuge-go and centrifuge-mobile do not support recovery at this moment and will only work with offset field in the future.

    ๐Ÿš€ It's important to mention that centrifuge-js, centrifuge-go and centrifuge-mobile will continue to work with a server which is using seq and gen fields for recovery until Centrifugo v3 release. With Centrifugo v3 release those libraries will be updated to only work with offset field.

    ๐Ÿ‘‰ Command centrifugo genconfig will now generate config file with v3_use_offset option enabled. Documentation has been updated to suggest turning on this option for fresh installations.

    ๐Ÿ‘Œ Improvements:

    • ๐Ÿ‘Œ support Redis Streams - radically reduces amount of memory allocations during recovery in large history streams. This also opens a road to paginate over history stream in future releases, see description of new redis_streams option in Redis engine docs
    • ๐Ÿ‘Œ support Redis Cluster, client-side sharding between different Redis Clusters also works, see more in docs
    • ๐Ÿ“œ faster HMAC-based JWT parsing
    • ๐Ÿ“‡ faster Memory engine, possibility to expire history stream metadata (more in docs)
    • ๐Ÿš€ releases for Centos 8, Debian Buster, Ubuntu Focal Fossa
    • ๐Ÿ†• new cli-command centrifugo gentoken to quickly generate HMAC SHA256 based connection JWT, see docs
    • ๐Ÿ†• new cli-command centrifugo checktoken to quickly validate connection JWT while developing application, see docs

    ๐Ÿ›  Fixes:

    • ๐Ÿ›  fix server side subscriptions to private channels (were ignored before)
    • ๐Ÿ›  fix channels counter update frequency in server info โ€“ this includes how fast channels counter updated in admin web interface (previously num clients and num users updated once in 3 seconds while num channels only once in a minute, now num channels updated once in 3 seconds too)

    ๐Ÿš€ This release based on Go 1.14.x

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.5.0
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.5
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest
  • v2.4.0

    March 08, 2020

    ๐Ÿš€ This release is a step towards new interesting possibilities with Centrifugo. It adds server-side subscriptions support and some sugar on top of it. With server-side subscriptions you don't need to call Subscribe method on client side at all. Follow release notes to know more.

    No backwards incompatible changes here.

    ๐Ÿ‘Œ Improvements:

    • ๐Ÿ“š Server-side subscriptions, this functionality requires updating client code so at moment usage is limited to centrifuge-js. Also there is a possibility to automatically subscribe user connection to personal notifications channel. More info in new documentation chapter
    • ๐Ÿ†• New private subscription JWT eto claim - see its description in docs
    • ๐Ÿ‘€ Options to disable WebSocket, SockJS and API handlers โ€“ see docs
    • ๐Ÿ‘‰ New option websocket_use_write_buffer_pool โ€“ see docs
    • Metrics now include histograms of requests durations - pull request
    • โž• Add Linux ARM binary release

    ๐Ÿ›  Fixes:

    • ๐Ÿ›  Fix unreliable unsubscriptions from Redis PUB/SUB channels under load, now we unsubscribe nodes from PUB/SUB channels over in-memory queue
    • ๐Ÿ›  Fix tls_external option regression

    ๐Ÿณ Docker images

    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.4.0
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2
    • ๐Ÿณ docker pull centrifugo/centrifugo:v2.4
    • ๐Ÿณ docker pull centrifugo/centrifugo:latest