v2.2.3

No backwards incompatible changes here.

Improvements:

• New chapter in docs: Benchmarking server. This chapter contains information about test stand inside Kubernetes with million WebSocket connections to a server based on Centrifuge library (the core of Centrifugo). It gives some numbers and insights about hardware requirements and scalability of Centrifugo
• New channel and channel namespace options: presence_disable_for_client and history_disable_for_client. presence_disable_for_client allows to make presence available only for server side API. history_disable_for_client allows to make history available only for server side API. Previously when enabled presence and history were available for both client and server APIs. Now you can disable for client side. History recovery mechanism if enabled will continue to work for clients anyway even if history_disable_for_client is on
• Wait for close handshake completion before terminating WebSocket connection from server side. This allows to gracefully shutdown WebSocket sessions

Fixes:

• Fix crash due to race condition, race reproduced when history recover option was on. See commit with fix details
• Fix lack of client_anonymous option. See #304

This release is based on Go 1.13.x

Docker images

• docker pull centrifugo/centrifugo:v2.2.3
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.2
• docker pull centrifugo/centrifugo:latest

v2.2.2

No backwards incompatible changes here.

Improvements:

• Support for tls-alpn-01 ACME challenge, see #283

Fixes:

• fix running HTTP server several times when http-01 ACME challenge used, see #288

Docker images

• docker pull centrifugo/centrifugo:v2.2.2
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.2
• docker pull centrifugo/centrifugo:latest

v2.2.1

This release fixes two regressions introduced by v2.2.0.

Improvements:

• New documentation chapter about GRPC API in Centrifugo.

Fixes:

• Fix client disconnect in channels with enabled history but disabled recovery
• Fix wrong Push type sent in Redis engine: Leave message was used where Join required

Docker images

• docker pull centrifugo/centrifugo:v2.2.1
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.2
• docker pull centrifugo/centrifugo:latest

v2.2.0

This release is based on latest refactoring of Centrifuge library. The refactoring opens a road for possible interesting improvements in Centrifugo – such as possibility to use any PUB/SUB broker instead of Redis (here is an example of possible integration with Nats server), or even combine another broker with existing Redis engine features to still have recovery and presence features. Though these ideas are not implemented in Centrifugo yet. Performance of broadcast operations can be slightly decreased due to some internal changes in Centrifuge library. Also take a close look at backwards incompatible changes section below for one breaking change.

Improvements:

• Track client position in channels with history_recover option enabled and disconnect in case of insufficient state. This resolves an edge case when messages could be lost in channels with history_recover option enabled after node reconnect to Redis (imagine situation when Redis was unavailable for some time but before Centrifugo node reconnects publisher was able to successfully send a message to channel on another node which reconnected to Redis faster). With new mechanism client won't miss messages though can receive them with some delay. As such situations should be pretty rare on practice it should be a reasonable compromise for applications. New mechanism adds more load on Redis as Centrifugo node periodically polls channel history state. The load is linearly proportional to amount of active channels with history_recover option on. By default Centrifugo will check client position in channel stream not often than once in 40 seconds so an additional load on Redis should not be too high
• New options for more flexible conrol over exposed endpoint interfaces and ports: internal_address, tls_external, admin_external. See description calling centrifugo -h. #262, #264
• Small optimizations in Websocket and SockjS transports writes
• Server initiated disconnect number metrics labeled with disconnect code

Backwards incompatible changes:

• This release removes a possibility to set uid to Publication over API. This feature was not documented in API reference and uid field does not make sense to be kept on client protocol top level as in Centrifugo v2 it does not serve any internal protocol purpose. This is just an application specific information that can be put into data payload

Release is based on Go 1.12.x

Docker images

• docker pull centrifugo/centrifugo:v2.2.0
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.2
• docker pull centrifugo/centrifugo:latest

v2.1.0

This release contains changes in metric paths exported to Graphite, you may need to fix your dashboard when upgrading. Otherwise everything in backwards compatible.

Improvements:

• Refactored export to Graphite, you can now control aggregation interval using graphite_interval option (in seconds), during refactoring some magical path transformation was removed so now we have more predictable path generation. Though Graphite paths changed with this refactoring
• Web interface rewritten using modern Javascript stack - latest React, Webpack instead of Gulp, ES6 syntax
• Aggregated metrics also added to info command reply. This makes it possible to look at metrics in admin panel too when calling info command
• More options can be set over environment variables – see #254
• Healthcheck endpoint – see #252
• New important chapter in docs – integration guide
• Support setting api_key when using Deploy on Heroku button
• Better timeout handling in Redis engine – client timeout is now bigger than default redis_read_timeout so application can more reliably handle errors

Fixes:

• Dockerfile had no correct WORKDIR set so it was only possible to use absolute config file path, now this is fixed in this commit
• Show node version in admin web panel
• Fix possible goroutine leak on client connection close, commit

Docker images

• docker pull centrifugo/centrifugo:v2.1.0
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.1
• docker pull centrifugo/centrifugo:latest

v2.0.2

Important If you are using rpm or deb packages from packagecloud.io then you have to re-run the installation method of your choice for Centrifugo repository. This is required to update GPG key used. This is a standard process that all packages hosted on packagecloud should do.

Improvements:

• Redis TLS connection support - see issue in Centrifuge lib and updated docs
• Do not send Authorization header in admin web interface when insecure admin mode enabled - helps to protect admin interface with basic authorization (see #240)

Fixes:

• Resubscribe only to shard subset of channels after reconnect to Redis (issue)

Docker images

• docker pull centrifugo/centrifugo:v2.0.2
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.0
• docker pull centrifugo/centrifugo:latest

v2.0.1

This release has several fixes and performance improvements

Improvements:

• Use latest SockJS url (SockJS version 1.3) for iframe transports
• Improve performance of massive subscriptions to different channels
• Allow dot in namespace names

Fixes:

• Fix of possible deadlock in Redis Engine when subscribe operation fails
• Fix admin web interface logout issue when session expired
• Fix io timeout error when using Redis Engine with sharding enabled
• Fix checkconfig command
• Fix typo in metric name - see #233

Docker images

• docker pull centrifugo/centrifugo:v2.0.1
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.0
• docker pull centrifugo/centrifugo:latest

v2.0.0

This is a new major version of Centrifugo. New version has some important changes and useful features – read new documentation.

Centrifugo v2 serves the same purpose as Centrifugo v1. Centrifugo v2 is not backwards compatible with v1 – migration to it will require adapting both backend and frontend sides of your application (of course if you decide to migrate).

Centrifugo is now based on new library centrifuge for Go language. That library can be used standalone to get even more than Centrifugo server provides – like custom authentication, your own permission management, asynchronous message passing, RPC calls etc.

Highlights of v2:

• Cleaner and more structured client-server protocol defined in protobuf schema. Protocol is more compact because some fields with default values that were sent previously now omitted
• Binary Websocket support (Protobuf). Protobuf allows to transfer data in much more compact and performant way than before. Of course JSON is still the main serialization format
• JWT for authentication and private channel authorization instead of hand-crafted HMAC sign. This means that there is no need in extra libraries to generate connection and subscription tokens. There are plenty of JWT libraries for all languages
• Prometheus integration and automatic export of stats to Graphite. Now Centrifugo easily integrates in modern monitoring stack – no need to manually export stats
• Refactored Javascript (ES6), Go and gomobile client libraries
• Simplified HTTP API authentication (no request body signing anymore)
• GRPC for server API
• New presence_stats API command to get compact presence information - how many clients and unique users in channel
• Structured logging with colored output during development
• Mechanism to automatically merge several Websocket messages into one to reduce syscall amount thus be more performant under heavy load
• Better recovery algorithm to fix several recovered flag false positives
• Goreleaser for automatic releases to Github

Some things were removed from Centrifugo in v2 release:

• Publishing over Redis queue
• Admin websocket endpoint
• Client limited channels
• Channel option history_drop_inactive now gone
• Websocket prepared message support (though this one can be pushed back at some point).

Documentation contains actual information and tips about migration from v1.

As mentioned above new version uses JWT tokens for authentication and private channel authorization. And there is no API request body signing anymore. This all means that using API clients (like cent, phpcent, jscent, rubycent, gocent before) is not necessary anymore – you can use any JWT library for your language and just send commands from your code – this is just simple JSON objects. Though API libraries still make sense to simplify integration a bit.

Currently the following clients work with v2:

• centrifuge-js – for browser, NodeJS and React Native.
• centrifuge-go - for Go language.
• centrifuge-mobile - for iOS and Android using centrifuge-go and gomobile project.
• centrifuge-dart – for Dart and Flutter. This lib is WIP and does not support all features yet.

At moment there are no native mobile clients. I.e. centrifuge-ios and centrifuge-android have not been updated to Centrifugo v2 yet.

Docker images

• docker pull centrifugo/centrifugo:v2.0.0
• docker pull centrifugo/centrifugo:v2
• docker pull centrifugo/centrifugo:v2.0
• docker pull centrifugo/centrifugo:latest

v2.0.0-beta.1

Changelog

Several fixes compared to previous alpha:

• add subscription expiration delay
• update admin web interface to latest version
• do not use colored logging into console on Windows

Docker images

• docker pull fzambia/centrifugo2:v2.0.0-beta.1
• docker pull fzambia/centrifugo2:v2
• docker pull fzambia/centrifugo2:v2.0
• docker pull fzambia/centrifugo2:latest

v2.0.0-alpha.2

Changelog

For alpha release there is no changelog - see #221 about Centrifugo v2

Documentation

Centrifugo v2 will have new documentation.

Clients

Clients are not released yet but you can find them in c2 branches:

• centrifuge-js – for browser, NodeJS and React Native.
• centrifuge-go - for Go language.
• centrifuge-mobile - for iOS and Android using centrifuge-go as basis and gomobile project to create bindings.

Docker images

For pre-releases Docker images use fzambia namespace but non pre-release versions will use centrifugal namespace as before.

• docker pull fzambia/centrifugo2:v2.0.0-alpha.2
• docker pull fzambia/centrifugo2:v2
• docker pull fzambia/centrifugo2:v2.0
• docker pull fzambia/centrifugo2:latest