Configuration file


Here is minimal configuration file required:

    "password": "admin",
    "cookie_secret": "secret",
    "api_secret": "secret"


  • password - administrator’s web interface password.
  • cookie_secret - used for security purposes, fill it with long random string and keep it in secret.
  • api_secret - administrator’s API secret key.

There is also a possibility to override default SockJS-Tornado settings using Centrifuge configuration file. Example:

    "password": "admin",
    "cookie_secret": "secret",
    "api_secret": "secret",
    "sockjs_settings": {
        "sockjs_url": ""

Here I set custom sockjs_url option, list of all available options can be found in sockjs-tornado source code: show on Github

Centrifuge runs a tornado HTTPServer under the hood. If you want to configure it you can do so via the tornado_settings. Please note that the io_loop argument is not supported for now. Example:

    "password": "admin",
    "cookie_secret": "secret",
    "api_secret": "secret",
    "tornado_settings": {
        "xheaders": true

Centrifuge also allows to collect and export various metrics into Graphite. You can configure metric collecting and exporting behaviour using metrics object in configuration JSON.

In example below I enable logging metrics, and export into service providing prefix, host and port to send metrics via UDP.

    "password": "admin",
    "cookie_secret": "secret",
    "api_secret": "secret",
    "metrics": {
        "admin": true,
        "log": true,
        "graphite": true,
        "graphite_host": "",
        "graphite_port": 2003,
        "graphite_prefix": "MY_HOSTED_GRAPHITE_KEY.centrifuge",
        "interval": 30

Metrics will be aggregated in a 30 seconds interval and then will be sent into log, into admin channel and into Graphite.

At moment Centrifuge collects for each node:

  • broadcast - time in milliseconds spent to broadcast messages (average, min, max, count of broadcasts)
  • connect - amount and rate of connect attempts to Centrifuge
  • transport - counters for different transports (websocket, xhr_polling etc)
  • messages - amount and rate of messages published
  • channels - amount of active channels
  • clients - amount of connected clients
  • unique_clients - amount of unique clients connected
  • api - count and rate of admin API calls

Command-line options

Centrifuge has several command line arguments.

--config - path to configuration json file

--debug - run Centrifuge in debug mode:

--port - port to bind (default 8000)

--name - unique node name (optional) - will be used in web interface metric table or in graphite data path

Some other command line options come with engine or structure storage backend - explore them using --help, for example:

CENTRIFUGE_ENGINE=redis centrifuge --help


CENTRIFUGE_STRUCTURE=sqlite centrifuge --help

Simple real-time messaging in web applications.


If you like Centrifuge, consider supporting the author:

Table Of Contents

Related Topics

This Page

Fork me on GitHub