How to Install SIPCAPTURE Homer on Fedora Server Latest?

In this tutorial, we will show you how to install SIPCAPTURE Homer on a Fedora Server.

Step 1: Update the system

Before installing any new software, it is always a good idea to check if there are any updates available for the existing packages.

sudo dnf update

Step 2: Install required packages

The installation process requires some packages that are not available by default. Here, we will install the required packages using dnf package manager.

sudo dnf install epel-release 
sudo dnf groupinstall "Development Tools" 
sudo dnf install mariadb mariadb-server mariadb-devel nginx

Step 3: Install Homer

Now, we will download and install Homer using the below commands.

sudo wget https://github.com/sipcapture/homer-api/releases/download/v9.0.0/homer-api-v9.0.0.tar.gz
sudo tar zxvf homer-api-v9.0.0.tar.gz
sudo mv homer-api-v9.0.0 /opt/
sudo chown -R homer:homer /opt/homer-api-v9.0.0

Step 4: Install dependencies

After installing Homer, install the required dependencies for Homer.

cd /opt/homer-api-v9.0.0/
sudo ./debian/utils/install_dependencies.sh

Step 5: Install MySQL schema

Create a database schema on MySQL for Homer.

mysql -u root -p

MariaDB [(none)]> CREATE DATABASE homer;
MariaDB [(none)]> CREATE USER 'homer_user'@'localhost' IDENTIFIED BY 'homer_password';
MariaDB [(none)]> GRANT ALL PRIVILEGES ON homer.* TO 'homer_user'@'localhost';
MariaDB [(none)]> FLUSH PRIVILEGES;

Now, import the schema to the homer database.

mysql -u homer_user -p homer < /opt/homer-api-v9.0.0/sql/mysql/homer_dbase_schema.sql

Step 6: Install and configure Nginx

Install and configure the Nginx web server.

sudo systemctl start nginx
sudo systemctl enable nginx
sudo vim /etc/nginx/conf.d/homer.conf

Add the following lines to the homer.conf file.

server {
        listen 80 default_server;
        listen [::]:80 default_server ipv6only=on;
        root /opt/homer-api-v9.0.0;
        index index.php index.html index.htm;
        server_name example.com;
        location / {
                try_files $uri $uri/ =404;
        }
        location /capture/uploads {
                internal;
                root /opt/homer-api-v9.0.0/capture;
        }
        location /api {
                try_files $uri /api/index.php$is_args$args;
        }
        location ~ \.php$ {
                try_files $uri =404;
                fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;
        }
}

Then, restart the Nginx service.

sudo systemctl restart nginx

Step 7: Start Homer

Start the Homer service and enable it to start automatically during system boot.

sudo systemctl start homer-api
sudo systemctl enable homer-api

Step 8: Check Homer installation

Access the Homer web interface using a web browser by entering http://. The login credentials are:

Username: admin
Password: changeme

Conclusion

In this tutorial, we have shown you how to install SIPCAPTURE Homer on a Fedora Server. Once you have Homer, you can use it to monitor, troubleshoot, and analyze SIP traffic.