OBSOLETE

For the latest homer containers please use: https://github.com/sipcapture/homer7-docker

HOMER Docker Containers

http://sipcapture.org

This repository provides ready-to-run HOMER recipes using Docker and docker-compose

Choosing a Capture Server & Backend

HOMER is all about options and easy integrations. Choose your preferred flavour to proceed:

• HOMER 7 development

  • HEPlify-Server

    • HEPlify + Prometheus
    • HEPlify + InfluxDB
    • HEPlify + InfluxDB + LoudML
    • HEPlify + Elastic
    • HEPlify + Elastic Headless

  • HEPop Server

    • HEPop + InfluxDB
    • HEPop + InfluxDB + LoudML
    • HEPop + InfluxDB + JSON for Janus/Mediasoup
    • HEPop + Elasticsearch + JSON for Janus/Mediasoup

• HOMER 5 legacy

  • HEPlify-Server

    • HEPlify-S + Prometheus
    • HEPlify-S + InfluxDB
    • HEPlify-S + Elasticsearch

  • OpenSIPS + sipcapture

  • Kamailio + sipcapture

Running Containers

To start your own bundle or choice, just run the following command inside the selected directory:

$ docker-compose up -d

Data Mapping

The docker-compose scheme will map container data into local directory volumes. Check and extend the provided examples accordingly.

Homer 5 compose operations

• Timezone: set TZ in homer.env (for example Europe/Berlin). Entrypoint scripts configure /etc/localtime at startup (#55).
• External MySQL: set USE_REMOTE_MYSQL=true and DB_HOST to your server hostname or IP (not mysql). Start with docker-compose -f docker-compose.yml -f docker-compose.external-mysql.yml up -d and omit the bundled mysql service (#59, #20).
• Single container + remote DB: use everything/run.sh with --dbhost or pass DB_HOST / MYSQL_ROOT_PASSWORD as environment variables; remote schemas are bootstrapped when missing (#20).
• Kamailio listen address: udp: 0.0.0.0:9060 in logs means the HEP socket listens on all interfaces inside the container; publish port 9060 in compose and point agents at the host IP (#91).
• Homer 7 / HEPv2: HEPlify Server in this tree expects HEPv3. Legacy Kamailio 4.4 HEPv2 senders need a HEPv2→v3 proxy or capture path upgrade (#90).
• CI / image builds: GitHub Actions workflow .github/workflows/docker.yml validates compose files and builds core images on master (#3, #49).

---

Made by Humans

This Open-Source project is made possible by actual Humans without corporate sponsors, angels or patreons.
If you use this software in production, please consider supporting its development with contributions or donations