How To Install ejabberd on CentOS: A Comprehensive Guide

Welcome to the Greenhost.cloud blog! Today, we’re diving into the world of instant messaging and real-time communication by exploring how to install ejabberd on a CentOS server. ejabberd is a highly robust, scalable, and open-source XMPP (Extensible Messaging and Presence Protocol) server that allows you to create a powerful messaging platform. Whether you’re setting up a chat service for your business, community, or personal use, ejabberd is a fantastic choice.

In this guide, we’ll take you step-by-step through the process of installing ejabberd on CentOS. Let’s get started!

Prerequisites

Before we begin, ensure you have the following:

1. CentOS Server: A fresh installation of CentOS (7 or 8) with root access.
2. Updated System: Make sure your system is up to date. You can do this by running:

   sudo yum update -y

3. Epel-release: Install the EPEL repository, which contains additional packages for CentOS.

   sudo yum install epel-release -y

Step 1: Install Erlang

ejabberd is built on Erlang, so the first step is to install the Erlang environment. To install it, run the following command:

sudo yum install erlang -y

Step 2: Download ejabberd

Next, we’ll download the latest version of ejabberd. Visit the official ejabberd website to find the latest version link, or use the following command to download it directly (make sure to replace the URL with the latest version):

wget https://www.ejabberd.im/downloads/ejabberd-23.07.tgz

Step 3: Extract the Package

Once the download is complete, extract the tarball:

tar -xzvf ejabberd-23.07.tgz

Step 4: Install ejabberd

Navigate into the extracted directory and run the installation script:

cd ejabberd-23.07
sudo make install

Step 5: Configure ejabberd

Now that ejabberd is installed, we need to configure it. The main configuration file is located at /etc/ejabberd/ejabberd.yml. Before editing, make a backup of the original file:

sudo cp /etc/ejabberd/ejabberd.yml /etc/ejabberd/ejabberd.yml.bak

Open the configuration file using your preferred text editor:

sudo nano /etc/ejabberd/ejabberd.yml

Here, you can configure the domain name, admin users, and other settings. Make sure to set the hosts field to your desired domain name or server IP address:

hosts:
  - "yourdomain.com"

Step 6: Start ejabberd

After configuring, start the ejabberd service using the following command:

sudo systemctl start ejabberd

To enable ejabberd to start on boot, run:

sudo systemctl enable ejabberd

Step 7: Access the ejabberd Web Admin Interface

ejabberd comes with a web administration interface that allows you to manage your server easily. By default, it runs on port 5280. You can access it via a web browser by navigating to:

http://yourdomain.com:5280/admin

Log in using the admin credentials you set in the configuration file.

Step 8: Configure Firewall

If you have a firewall enabled on your CentOS server, you need to allow traffic on the necessary ports. Run the following commands to open the required ports:

sudo firewall-cmd --permanent --zone=public --add-port=5222/tcp
sudo firewall-cmd --permanent --zone=public --add-port=5269/tcp
sudo firewall-cmd --permanent --zone=public --add-port=5280/tcp
sudo firewall-cmd --reload

Conclusion

Congratulations! You have successfully installed ejabberd on your CentOS server. You can now start building your own messaging application or chat service. With its powerful features and easy-to-use management interface, ejabberd is a great choice for anyone looking to implement real-time communication.

If you have any questions or need further assistance, feel free to leave a comment below. Happy messaging!

About Greenhost.cloud: At Greenhost.cloud, we provide reliable and scalable cloud hosting solutions tailored to meet your needs. Whether you’re a small business or a large enterprise, our services are designed to help you thrive in the digital world. Explore our offerings and get started today!