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:

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.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!