How to Install SIPCAPTURE Homer on Ubuntu Server Latest

In this tutorial, we will guide you through the installation process of SIPCAPTURE Homer on Ubuntu Server.

Prerequisites

Before we begin, ensure that you have:

• An Ubuntu Server with the latest updates installed.
• A working internet connection.

Step 1 - Add Repository & Install Dependencies

1. Open the Terminal and update package lists:

   sudo apt-get update
   

2. Install the required packages:

   sudo apt-get install -y wget lsb-release gnupg2
   

3. Add the SIPCAPTURE apt repository:

   wget -O- https://packages.irontec.com/public.key | sudo apt-key add -
   

4. Add the repository to Ubuntu:

   echo "deb https://packages.irontec.com/debian `lsb_release -cs` main" | sudo tee /etc/apt/sources.list.d/irontec.list
   

5. Update package lists again:

   sudo apt-get update
   

Step 2 - Install Homer

1. Install Homer's core package:

   sudo apt-get install homer-core
   

2. Create a home directory for Homer:

   sudo mkdir -p /home/homer/
   

3. Change the owner and group permissions of the Homer home directory:

   sudo chown -R homer:homer /home/homer/
   

Step 3 - Install & Configure Capture Agent

1. Install Capture Agent:

   sudo apt-get install homer-capture-agent
   

2. Configure Capture Agent by editing the file /etc/homer-capture-agent/homer_capture_agent.conf:

   sudo nano /etc/homer-capture-agent/homer_capture_agent.conf
   

   Change the values of HOMERHOST, HOMERPORT, SAFETYNET according to your settings.

   For example:

   # HOMER REST-API server connectivity
   HOMERHOST=homer.example.com
   HOMERPORT=9060
   HOMERUSER=homer_user
   HOMERPASS=homer_password
   
   # SafetyNet Buffering (set to -1 to enable buffering)
   SAFETYNET=-1
   

3. Start the Capture Agent service:

   sudo systemctl enable homer-capture-agent.service
   sudo systemctl start homer-capture-agent.service
   

Step 4 - Install & Configure SIP Server

1. Install SIP Server:

   sudo apt-get install homer-sipcapture-udp
   

2. Configure SIP Server by editing the file /etc/homer-api/sipcapture.conf:

   sudo nano /etc/homer-api/sipcapture.conf
   

   Change the values of CAPTUREHOST, CAPTUREPORT, CAPTUREID according to your settings.

   For example:

   # Local Interface/IP
   BIND_INTERFACE=0.0.0.0
   
   ### SIP CAPTURE Agent Configuration 
   HEP_SERVER_NAME=homer.example.com
   HEP_PORT=9060
   
   ### SIP Capture Configuration
   CAPTUREHOST=0.0.0.0
   CAPTUREPORT=5060
   NIC=any
   
   ### Protocol id
   CAPTUREID=2001
   

3. Start the SIP Server service:

   sudo systemctl enable homer-sipcapture-udp.service
   sudo systemctl start homer-sipcapture-udp.service
   

Step 5 - Configure Firewall

1. Allow traffic on port 5060 and 9060:

   sudo ufw allow proto udp from any to any port 5060
   sudo ufw allow proto tcp from any to any port 9060
   

Step 6 - Access Homer UI

1. Open a web browser and go to:

   http://your-server-address:8080
   

   Replace your-server-address with the IP address or hostname of your server.

2. You should be redirected to the Homer login page. Use the following credentials to log in:

   • Username: admin
   • Password: changeme

3. You should see the Homer dashboard.

Congratulations! You have successfully installed and configured SIPCAPTURE Homer on Ubuntu Server Latest.