Skip to main content

Install and run PRO version

Centrifugo PRO license agreement

Centrifugo PRO is distributed by Centrifugal Labs LTD under commercial license which is different from OSS version. By downloading Centrifugo PRO you automatically accept commercial license terms.

Binary release​

Centrifugo PRO binary releases available on Github. Note that we use a separate repo for PRO releases. Download latest release for your operating system, unpack it and run (see how to set license key below).

If you doubt which distribution you need, then on Linux or MacOS you can use the following command to download and unpack centrifugo binary to your current working directory:

curl -sSLf https://centrifugal.dev/install_pro.sh | sh

Docker image​

Centrifugo PRO uses a different image from OSS version – centrifugo/centrifugo-pro:

docker run --ulimit nofile=262144:262144 -v /host/dir/with/config/file:/centrifugo -p 8000:8000 centrifugo/centrifugo-pro:v5.4.2 centrifugo -c config.json

Kubernetes​

You can use our official Helm chart but make sure you changed Docker image to use PRO version and point to the correct image tag:

values.yaml
...
image:
  registry: docker.io
  repository: centrifugo/centrifugo-pro
  tag: v5.4.2

Debian and Ubuntu​

DEB package available in release assets.

wget https://github.com/centrifugal/centrifugo-pro/releases/download/v5.4.2/centrifugo-pro_5.4.2-0_amd64.deb
sudo dpkg -i centrifugo-pro_5.4.2-0_amd64.deb

Centos​

RPM package available in release assets.

wget https://github.com/centrifugal/centrifugo-pro/releases/download/v5.4.2/centrifugo-pro-5.4.2-0.x86_64.rpm
sudo yum install centrifugo-pro-5.4.2-0.x86_64.rpm

Setting PRO license key​

Centrifugo PRO inherits all features and configuration options from open-source version. The only difference is that it expects a valid license key on start to avoid sandbox mode limits.

Once you have installed a PRO version and have a license key you can set it in configuration over license field, or pass over environment variables as CENTRIFUGO_LICENSE. Like this:

config.json
{
    ...
    "license": "<YOUR_LICENSE_KEY>"
}
tip

If license properly set then on Centrifugo PRO start you should see license information in logs: owner, license type and expiration date. All PRO features should be unlocked at this point. Warning about sandbox mode in logs on server start must disappear.