How to Install Centrifugo on Fedora Server Latest

Centrifugo is a scalable real-time messaging server. It allows you to create a real-time messaging API for your application, with features such as authenticated connections, channel presence, and history. In this tutorial, we will guide you through the process of installing Centrifugo on Fedora Server Latest.

Prerequisites

Before we begin, make sure that your server meets the following requirements:

  • A running instance of Fedora Server Latest
  • A sudo user with root privileges (for running administrative commands)

Step 1: Update the System

Before installing any software, it's always a good practice to update the system to the latest available packages. 

sudo dnf update -y

Step 2: Install Redis

Centrifugo requires Redis to function properly. To install Redis on Fedora: 

sudo dnf install redis -y

After installation, start the Redis service and enable it to start on boot: 

sudo systemctl start redis
sudo systemctl enable redis

Step 3: Install Centrifugo

Centrifugo offers pre-built binaries for Linux on their website. To download the latest version: 

wget https://github.com/centrifugal/centrifugo/releases/download/v3.2.2/centrifugo_3.2.2_linux_amd64.tar.gz

Extract the downloaded archive: 

tar -xzf centrifugo_3.2.2_linux_amd64.tar.gz

Move the extracted binary to /usr/local/bin/ and make it executable: 

sudo mv centrifugo /usr/local/bin/
sudo chmod +x /usr/local/bin/centrifugo

Step 4: Configure Centrifugo

Copy the Centrifugo default configuration file to a new location: 

sudo cp /usr/local/bin/centrifugo/config.json /etc/centrifugo/config.json

Edit the configuration file to suit your needs: 

sudo nano /etc/centrifugo/config.json

Make sure to add your Redis server information in the "redis" section of the configuration file, as well as any authentication settings for your application.

Step 5: Create Systemd Service

Create a new systemd service for Centrifugo: 

sudo nano /etc/systemd/system/centrifugo.service

Paste the following content in the file: 

[Unit]
Description=Centrifugo Real-Time Messaging Server
After=syslog.target network.target

[Service]
User=root
ExecStart=/usr/local/bin/centrifugo -c /etc/centrifugo/config.json
Restart=on-failure
RestartSec=10
KillMode=process

[Install]
WantedBy=multi-user.target

Save and close the file.

Enable the Centrifugo service to start on boot: 

sudo systemctl enable centrifugo.service

Step 6: Start Centrifugo

Start the Centrifugo service: 

sudo systemctl start centrifugo.service

Check the status of the Centrifugo service: 

sudo systemctl status centrifugo.service

If the service is running, you should see output similar to the following: 

● centrifugo.service - Centrifugo Real-Time Messaging Server
   Loaded: loaded (/etc/systemd/system/centrifugo.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2021-10-13 10:47:41 EDT; 1s ago
 Main PID: 166141 (centrifugo)
    Tasks: 6 (limit: 7149)
   Memory: 21.1M
   CGroup: /system.slice/centrifugo.service
           └─166141 /usr/local/bin/centrifugo -c /etc/centrifugo/config.json

Oct 13 10:47:41 fedora systemd[1]: Started Centrifugo Real-Time Messaging Server.

Step 7: Configure Firewall

If you have a firewall enabled on your server, make sure to allow traffic on the port that Centrifugo is listening on (default is 8000). For example, to allow traffic on port 8000: 

sudo firewall-cmd --zone=public --add-port=8000/tcp --permanent
sudo firewall-cmd --reload

Conclusion

Centrifugo should now be installed and running on your Fedora Server Latest instance. You can now use Centrifugo to provide real-time messaging functionality to your application.