Guide for Debian 12 users who prefer running Homer 10, QRYN, and Grafana in a Linux environment using Docker.

SIP Capture with Homer 10 under Debian 12

For full use of this feature described in this chapter, anynode version 4.14 or higher is required.

This chapter is intended as a Linux-based companion to the Windows deployment guide. It provides equivalent steps for Debian 12 users who prefer running Homer 10, QRYN, and Grafana in a Linux environment using Docker.

This installation script sets up a complete Homer 10 + QRYN + Grafana stack on Debian 12 (Bookworm) using Docker. Specifically, it:

  • Installs required system packages (Docker, Git, curl, etc.)

  • Adds the official Docker repository & GPG key

  • Installs Docker Engine and Compose plugin

  • Clones the official Homer Docker repository

  • Starts the "all-in-one" deployment via docker compose

Exposes

HEP port: 9060 (UDP/TCP)

Homer Web UI: http://:9080

Grafana Dashboard: http://:3000 (admin / admin)

Installation Script

Filename: install-homer-qryn.sh

#!/bin/bash
echo "----------------------------------------"
echo " QRYN / HOMER Capture Installer"
echo " for Debian 12 (Bookworm)"
echo "----------------------------------------"
# Check for root permissions
if [ "$EUID" -ne 0 ]; then
  echo "Please run as root: sudo bash install-homer-qryn.sh"
  exit
fi
echo "[1/8] Updating system..."
apt update && apt upgrade -y
echo "[2/8] Installing required packages..."
apt install -y ca-certificates curl gnupg lsb-release git
echo "[3/8] Adding Docker GPG key..."
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
chmod a+r /etc/apt/keyrings/docker.gpg
echo "[4/8] Adding Docker repository..."
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/debian \
  $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list
echo "[5/8] Installing Docker..."
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
echo "[6/8] Enabling Docker service..."
systemctl enable --now docker
echo "[7/8] Cloning qryn/homer-docker repository..."
if [ -d "/opt/homer-docker" ]; then
  echo "Directory /opt/homer-docker already exists, skipping clone..."
else
  git clone https://github.com/sipcapture/homer-docker.git /opt/homer-docker
fi
echo "[8/8] Starting qryn stack..."
cd /opt/homer-docker/all-in-one
docker compose up -d
echo ""
echo "========================================"
echo " QRYN / HOMER installation completed!"
echo "========================================"
echo ""
echo "Grafana Web Interface:"
echo " http://<IP-address>:3000"
echo ""
echo "Login:"
echo " Username: admin"
echo " Password: admin"
echo ""
echo "Send HEP data to:"
echo " udp://<IP-address>:9060"
echo " tcp://<IP-address>:9060"
echo ""
echo "Show running containers with:"
echo " sudo docker ps"
echo ""
echo "Installation finished."

How to create and run the installation script

Create the script with nano

sudo nano install-homer-qryn.sh

Nano opens → now paste the complete script inside.

Save the file in nano

Inside nano press

CTRL + O (Write file)ENTER (Confirm filename)CTRL + X (Exit nano)

Make the script executable

sudo chmod +x install-homer-qryn.sh

Run the script

sudo ./install-homer-qryn.sh

What You May Still Need to Do

HEP Source Configuration

Ensure your SIP capture agents (e.g. anynode, Kamailio, SBCs) send HEP traffic to:

udp://<server-ip>:9060

Firewall Rules (if applicable)

Open UDP port 9060:

ufw allow 9060/udp

Optional Configuration Adjustments

Editdocker-compose.yml for:

  • Custom ports

  • Passwords

  • Volume mounts (for data persistence)

Configuration of the SIP Capture Agent in anynode is described in the previous Windows chapter using the SIP Capture Assistant.

Please refer to chapter SIP Capture with Homer 10 / Grafana (Windows) if you need guidance on setting up HEP forwarding from anynode.