v4.1.0

Centrifugo is an open-source scalable real-time messaging server. Centrifugo can instantly deliver messages to application online users connected over supported transports (WebSocket, HTTP-streaming, SSE/EventSource, GRPC, SockJS, WebTransport). Centrifugo has the concept of a channel – so it's a user-facing PUB/SUB server.

Centrifugo is language-agnostic and can be used to build chat apps, live comments, multiplayer games, real-time data visualizations, collaborative tools, etc. in combination with any backend. It is well suited for modern architectures and allows decoupling the business logic from the real-time transport layer.

Several official client SDKs for browser and mobile development wrap the bidirectional protocol. In addition, Centrifugo supports a unidirectional approach for simple use cases with no SDK dependency.

For details, go to the Centrifugo documentation site.

Release notes

This release contains a rewrite of our Redis Engine. While we expect things to work just fine and in backwards compatible way – please check your app in test environment with new Centrifugo version in case of using Redis Engine. Also, keep more attention than usual to metrics upon upgrading in production. See more details and link to the blog post below.

Improvements

• 🔥 🔥 🔥 Fully rewritten Redis engine using rueian/rueidis library. Many thanks to @j178 and @rueian for the help. Check out details in our blog post Improving Centrifugo Redis Engine throughput and allocation efficiency with Rueidis Go library. We expect that new implementation is backwards compatible with the previous one except some timeout options which were not documented, please report issues if any.
• Extended TLS configuration for Redis – it's now possible to set CA root cert, client TLS certs, set custom server name for TLS. See more details in the updated Redis Engine option docs. Also, it's now possible to provide certificates as strings, not only as paths to files.

v4.0.5

Centrifugo is an open-source scalable real-time messaging server. Centrifugo can instantly deliver messages to application online users connected over supported transports (WebSocket, HTTP-streaming, SSE/EventSource, GRPC, SockJS, WebTransport). Centrifugo has the concept of a channel – so it's a user-facing PUB/SUB server.

Centrifugo is language-agnostic and can be used to build chat apps, live comments, multiplayer games, real-time data visualizations, collaborative tools, etc. in combination with any backend. It is well suited for modern architectures and allows decoupling the business logic from the real-time transport layer.

Several official client SDKs for browser and mobile development wrap the bidirectional protocol. In addition, Centrifugo supports a unidirectional approach for simple use cases with no SDK dependency.

For details, go to the Centrifugo documentation site.

Release notes

Fixes

• Fix non-working bidirectional emulation in multi-node case #590
• Process client channels for no-credentials case also, see issue #581
• Fix setting allow_positioning for top-level namespace, commit

Misc

• This release is built with Go 1.19.4

v4.0.4

Centrifugo is an open-source scalable real-time messaging server. Centrifugo can instantly deliver messages to application online users connected over supported transports (WebSocket, HTTP-streaming, SSE/EventSource, GRPC, SockJS, WebTransport). Centrifugo has the concept of a channel – so it's a user-facing PUB/SUB server.

Centrifugo is language-agnostic and can be used to build chat apps, live comments, multiplayer games, real-time data visualizations, collaborative tools, etc. in combination with any backend. It is well suited for modern architectures and allows decoupling the business logic from the real-time transport layer.

Several official client SDKs for browser and mobile development wrap the bidirectional protocol. In addition, Centrifugo supports a unidirectional approach for simple use cases with no SDK dependency.

For details, go to the Centrifugo documentation site.

Release notes

This release contains an important fix of Centrifugo memory leak. The leak happens in all setups which use Centrifugo v4.0.2 or v4.0.3.

Fixes

• Fix goroutine leak on connection close introduced by v4.0.2, commit

Misc

• This release is built with Go 1.19.3

v4.0.3

Centrifugo is an open-source scalable real-time messaging server. Centrifugo can instantly deliver messages to application online users connected over supported transports (WebSocket, HTTP-streaming, SSE/EventSource, GRPC, SockJS, WebTransport). Centrifugo has the concept of a channel – so it's a user-facing PUB/SUB server.

Centrifugo is language-agnostic and can be used to build chat apps, live comments, multiplayer games, real-time data visualizations, collaborative tools, etc. in combination with any backend. It is well suited for modern architectures and allows decoupling the business logic from the real-time transport layer.

Several official client SDKs for browser and mobile development wrap the bidirectional protocol. In addition, Centrifugo supports a unidirectional approach for simple use cases with no SDK dependency.

For details, go to the Centrifugo documentation site.

Release notes

Fixes

• Fix insensitive case match for granular proxy headers, #572

v4.0.2

Centrifugo is an open-source scalable real-time messaging server. Centrifugo can instantly deliver messages to application online users connected over supported transports (WebSocket, HTTP-streaming, SSE/EventSource, GRPC, SockJS, WebTransport). Centrifugo has the concept of a channel – so it's a user-facing PUB/SUB server.

Centrifugo is language-agnostic and can be used to build chat apps, live comments, multiplayer games, real-time data visualizations, collaborative tools, etc. in combination with any backend. It is well suited for modern architectures and allows decoupling the business logic from the real-time transport layer.

Several official client SDKs for browser and mobile development wrap the bidirectional protocol. In addition, Centrifugo supports a unidirectional approach for simple use cases with no SDK dependency.

For details, go to the Centrifugo documentation site.

Release notes

This release contains one more fix of v4 degradation (not respecting force_push_join_leave option for top-level namespace), comes with updated admin web UI and other improvements.

Fixes

• Handle force_push_join_leave option set for top-level namespace – it was ignored so join/leave messages were not delivered to clients, commit
• Properly handle b64data in server publish API, commit

Improvements

• Updated admin web UI. It now uses modern React stack, fresh look based on Material UI and several other small improvements. See #566 for more details
• Case-insensitive http proxy header configuration #558
• Use Alpine 3.16 instead of 3.13 for Docker builds, commit
• Add missing empty object results to API command responses, commit
• Disconnect clients in case of inappropriate protocol centrifugal/centrifuge#256

Misc

• This release is built with Go 1.19.2

v4.0.1

Centrifugo is an open-source scalable real-time messaging server. Centrifugo can instantly deliver messages to application online users connected over supported transports (WebSocket, HTTP-streaming, SSE/EventSource, GRPC, SockJS, WebTransport). Centrifugo has the concept of a channel – so it's a user-facing PUB/SUB server.

Centrifugo is language-agnostic and can be used to build chat apps, live comments, multiplayer games, real-time data visualizations, collaborative tools, etc. in combination with any backend. It is well suited for modern architectures and allows decoupling the business logic from the real-time transport layer.

Several official client SDKs for browser and mobile development wrap the bidirectional protocol. In addition, Centrifugo supports a unidirectional approach for simple use cases with no SDK dependency.

For details, go to the Centrifugo documentation site.

Release notes

This release contains an important fix of v4 degradation (proxying user limited channel) and comes with several nice improvements.

Fixes

• Avoid proxying user limited channel #550
• Look at subscription source to handle token subs change #545

Improvements

• Configure server-to-client ping/pong intervals #551, docs
• Option client_connection_limit to set client connection limit for a single Centrifugo node #546, docs
• Option api_external to expose API handler on external port #536
• Use go.uber.org/automaxprocs to set GOMAXPROCS #528, this may help to automatically improve Centrifugo performance when it's running in an environment with cgroup-restricted CPU resources (Docker, Kubernetes).
• Nats broker: use push format from client protocol v2 #542

Misc

• While working on Centrifuge lib @j178 found a scenario where connection to Redis could leak, this was not observed and reported in Centrifugo outside the test suite, but it seems that theoretically connections to Redis from Centrifugo could leak with time if the network between Centrifugo and Redis is unstable. This release contains an updated Redis engine which eliminates this.
• This release is built with Go 1.18.5

v4.0.0

Centrifugo is an open-source scalable real-time messaging server. Centrifugo can instantly deliver messages to application online users connected over supported transports (WebSocket, HTTP-streaming, SSE/EventSource, GRPC, SockJS, WebTransport). Centrifugo has the concept of a channel – so it's a user-facing PUB/SUB server.

Centrifugo is language-agnostic and can be used to build chat apps, live comments, multiplayer games, real-time data visualizations, collaborative tools, etc. in combination with any backend. It is well suited for modern architectures and allows decoupling the business logic from the real-time transport layer.

Several official client SDKs for browser and mobile development wrap the bidirectional protocol. In addition, Centrifugo supports a unidirectional approach for simple use cases with no SDK dependency.

For details, go to the Centrifugo documentation site.

About v4 release

New v4 release takes Centrifugo to the next level in terms of client protocol performance, WebSocket fallback simplicity, SDK ecosystem and channel security model. It also comes with a couple of cutting-edge technologies to experiment with such as HTTP/3 and WebTransport.

This is a major release with breaking changes according to our Centrifugo v4 roadmap.

Several important documents we have at this point can help you get started with Centrifugo v4:

• Centrifugo v4 release blog post
• Centrifugo v3 -> v4 migration guide
• Client SDK API specification
• Updated quickstart tutorial

Highlights

• New client protocol iteration and unified client SDK API. See client SDK API specification.
• All SDKs now support all the core features of Centrifugo - see feature matrix
• Our own WebSocket bidirectional emulation layer based on HTTP-streaming and SSE (EventSource). Without sticky session requirement for a distributed case. See details in release post and centrifuge-js README
• SockJS is still supported but DEPRECATED
• Redesigned, more efficient PING-PONG – see details in release post
• Optimistic subscriptions support (implemented in centrifuge-js only at this point) – see details in release post
• Secure by default channel namespaces – see details in release post
• Private channel and subscription JWT concepts revised – see details in release post
• Possibility to enable join/leave, recovery and positioning from the client-side
• Experimental HTTP/3 support - see details in release post
• Experimental WebTransport support - see details in release post
• Avoid sending JSON in WebSocket Close frame reason
• Temporary flag for errors, allows resilient behavior of Subscriptions
• gensubtoken and checksubtoken helper cli commands as subscription JWT now behaves similar to connection JWT
• Legacy options removed, some options renamed, see migration guide for details.
• meta attached to a connection now updated upon connection refresh
• centrifuge-js migrated to Typescript
• The docs on centrifugal.dev were updated for v4, docs for v3 are still there but under version switch widget.
• Use constant time compare function to compare admin_password and api_key #527

Misc

• This release is built with Go 1.18.4

v4.0.0-beta.1

This is a first beta release of Centrifugo v4. Please refer to Centrifugo v4 roadmap for latest details about v4 (and docs on centrifugal.dev already have almost finished docs for v4).

Some useful docs:

• Centrifugo v3 -> v4 migration guide
• Client SDK API specification
• Updated quickstart tutorial

We now have Centrifugo v4 beta and recently released centrifuge-js v3.0.0-beta.0. So it's already possible to try things out without using custom branches etc.

Obviously, this release is not for production usage, and some changes can still happen. Please reach out in community chat if you want to try beta release but came across questions/issues - highly appreciate the feedback.

v3.2.3

Centrifugo is an open-source scalable real-time messaging server in a language-agnostic way. It can be a missing piece in your application infrastructure for introducing real-time features. Think chats, live comments, multiplayer games, streaming metrics – you'll be able to build amazing web and mobile real-time apps with a help of Centrifugo. Choose the approach you like:

• bidirectional communication over WebSocket or SockJS
• or unidirectional communication over WebSocket, EventSource (Server-Sent Events), HTTP-streaming, GRPC
• or... combine both!

See centrifugal.dev for more information.

Release notes

No backwards incompatible changes here.

Improvements

• Support Debian bullseye DEB package release, drop Debian jessie, #520

Fixes

• Fix emitting Join message in dynamic server subscribe case (when calling subscribe server API), centrifugal/centrifuge#231.

v3.2.2

Centrifugo is an open-source scalable real-time messaging server in a language-agnostic way. It can be a missing piece in your application infrastructure for introducing real-time features. Think chats, live comments, multiplayer games, streaming metrics – you'll be able to build amazing web and mobile real-time apps with a help of Centrifugo. Choose the approach you like:

• bidirectional communication over WebSocket or SockJS
• or unidirectional communication over WebSocket, EventSource (Server-Sent Events), HTTP-streaming, GRPC
• or... combine both!

See centrifugal.dev for more information.

Release notes

No backwards incompatible changes here.

Fixes

• Fix top-level granular subscribe and publish proxies #517.

Misc

• This release is built with Go 1.17.11.