Skip to main content

Centrifugo introduction

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). 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.


By real-time, we indicate a soft real-time. Due to network latencies, garbage collection cycles, and so on, the delay of a delivered message can be up to several hundred milliseconds or higher.


Centrifugo was born a decade ago to help applications with a server-side written in a language or a framework without built-in concurrency support. In this case, dealing with persistent connections is a real headache that usually can only be resolved by introducing a shift in the technology stack and spending time to create a production-ready solution.

For example, frameworks like Django, Flask, Yii, Laravel, Ruby on Rails, and others have poor or not really performant support of working with many persistent connections for the real-time messaging tasks.

In this case, Centrifugo is a straightforward and non-obtrusive way to introduce real-time updates and handle lots of persistent connections without radical changes in the application backend architecture. Developers could proceed writing the application backend with a favorite language or favorite framework, keep existing architecture – and just let Centrifugo deal with persistent connections.

At the moment, Centrifugo provides some advanced and unique features that can simplify a developer's life and save months of development, even if the application backend is built with the asynchronous concurrent language. One example is that Centrifugo can scale out-of-the-box to many machines with several supported brokers. And there are more things to mention – see detailed highlights further in the docs.

Basic concept

As mentioned above, Centrifugo runs as a standalone service that cares about handling persistent connections from the application users. The application backend and frontend can be written in any programming language. Clients connect to Centrifugo and subscribe to channels.

As soon as some event happens the application backend can publish a message with event payload into a channel using Centrifugo publishing API. The message will be delivered to all clients currently connected and subscribed to a channel.

That's right, Centrifugo is basically a user-facing PUB/SUB server. Here is a simplified scheme:

Centrifugo scheme

Although the basic concept is simple, there are many challenges on the way to a production-ready system with a developer-friendly API and scalability. Centrifugo tries to solve them for you. We are describing many interesting solutions and advanced features in the documentation and our blog.

Join community

By the way, we have rooms in Telegram (the most active) and Discord:

Join the chat at  Join the chat at

We also have Twitter account and Youtube channel.

See you there!