{"id":13398918,"url":"https://github.com/sipcapture/heplify-server","last_synced_at":"2025-04-04T13:11:06.629Z","repository":{"id":30573766,"uuid":"120283274","full_name":"sipcapture/heplify-server","owner":"sipcapture","description":"HEP Capture Server for HOMER","archived":false,"fork":false,"pushed_at":"2024-07-07T09:48:25.000Z","size":3880,"stargazers_count":182,"open_issues_count":20,"forks_count":86,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-07-31T19:17:26.935Z","etag":null,"topics":["capture-server","go","grafana","hep","homer","loki","metrics","mirroring","monitoring","prometheus","rtcp","sip","trunk","voip"],"latest_commit_sha":null,"homepage":"https://sipcapture.org","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sipcapture.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["qxip"],"custom":["https://bunq.me/qxip"]}},"created_at":"2018-02-05T09:30:21.000Z","updated_at":"2024-07-26T18:46:24.000Z","dependencies_parsed_at":"2024-01-18T11:03:12.801Z","dependency_job_id":"9a7e0a5a-7602-4107-865e-08e4356866b9","html_url":"https://github.com/sipcapture/heplify-server","commit_stats":null,"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2Fheplify-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2Fheplify-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2Fheplify-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2Fheplify-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sipcapture","download_url":"https://codeload.github.com/sipcapture/heplify-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247182335,"owners_count":20897379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["capture-server","go","grafana","hep","homer","loki","metrics","mirroring","monitoring","prometheus","rtcp","sip","trunk","voip"],"created_at":"2024-07-30T19:00:32.710Z","updated_at":"2025-04-04T13:11:06.612Z","avatar_url":"https://github.com/sipcapture.png","language":"Go","readme":"\u003ca href=\"https://sipcapture.org\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/1423657/55069501-8348c400-5084-11e9-9931-fefe0f9874a7.png\" width=200/\u003e\u003c/a\u003e\n\n![image](https://user-images.githubusercontent.com/1423657/38167610-1bccc596-3538-11e8-944c-8bd9ee0433b2.png)\n\n\u003cimg src=\"https://img.shields.io/docker/pulls/sipcapture/heplify-server\"\u003e\n\n**heplify-server** is a stand-alone **HOMER** capture server developed in Go, optimized for speed and simplicity. Distributed as a single binary ready to capture TLS and UDP **HEP**, Protobuf encapsulated packets from [heplify](https://github.com/sipcapture/heplify) or any other [HEP](https://github.com/sipcapture/hep) enabled agent, indexing to database and rotating using H5 or H7 table format. **heplify-server** provides precise SIP and RTCP metrics with the help of Prometheus and Grafana. It gives you the possibility to get a global view on your network and individual SIP trunk monitoring.\n\n*TLDR; minimal, stand-alone HOMER capture server without Kamailio or OpenSIPS dependency. It's not as customizeable as Kamailio or OpenSIPS with their configuration language, the focus is simplicity!*\n\n------\n\n### Installation\nYou have 3 options to get **heplify-server** up and running:\n\n* Download a [release](https://github.com/sipcapture/heplify-server/releases)\n* Docker [compose](https://github.com/sipcapture/heplify-server/tree/master/docker/hom5-hep-prom-graf)\n* Compile from sources:  \n  \n  Install gcc and luajit dev libary\n  \n  `apt-get install build-essential libluajit-5.1-dev`\n  \n  or \n  \n  `yum install luajit-devel`\n\n  or for macOS\n\n  ```sh\n  # Assuming brew installs to /usr/local/\n  brew install lua@5.1 luajit\n  ln -s /usr/local/lib/pkgconfig/luajit.pc /usr/local/lib/pkgconfig/luajit-5.1.pc\n  export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/\n  ```\n  \n  [install](https://golang.org/doc/install) Go 1.11+\n\n  `go build cmd/heplify-server/heplify-server.go`\n  \n  \n\n### Requirements\nThese depend on which features you want to use and on whether you use homer5 or homer7 schema. For homer5, you need MySQL \u003e= 5.7 or MariaDB \u003e= 10. For homer7 you need PostgreSQL \u003e= 10.\n\n### Configuration\n**heplify-server** can be configured using command-line flags, environment variables, or a local [configuration file](https://github.com/sipcapture/heplify-server/blob/master/example/) or via web form by setting ConfigHTTPAddr  \n\n![image](https://user-images.githubusercontent.com/20154956/54483281-ef3f5700-4850-11e9-8da1-9b8bed6186e3.png)\n\nTo set up a systemd service, use the sample [service file](https://github.com/sipcapture/heplify-server/blob/master/example/) \nand follow the instructions found at the top of the file.\n\nSince version 0.92 it is possible to hot reload PromTargetIP and PromTargetName when you change them inside the configuration file.\n```\nkillall -HUP heplify-server\n```\n\n### Running\n##### Stand-Alone\n```\n./heplify-server -h\n```\n##### Docker\nA sample Docker [compose](https://github.com/sipcapture/heplify-server/tree/master/docker/hom5-hep-prom-graf) file is available providing heplify-server, Homer 5 UI, Prometheus, Alertmanager and Grafana in seconds!\n```\ncd heplify-server/docker/hom5-hep-prom-graf/\ndocker-compose up -d\n```\n\n### Support\n* Testers, Reporters and Contributors [welcome](https://github.com/sipcapture/heplify-server/issues)\n\n### Screenshots\n![sip_metrics](https://user-images.githubusercontent.com/20154956/39880524-57838c04-547e-11e8-8dec-262184192742.png)\n![xrtp](https://user-images.githubusercontent.com/20154956/39880861-4b1a2b34-547f-11e8-8d38-69fa88713aa9.png)\n![loki](https://user-images.githubusercontent.com/20154956/70985139-ee777200-20bb-11ea-867b-200cd7e1b6b8.png)\n----\n#### Made by Humans\nThis Open-Source project is made possible by actual Humans without corporate sponsors, angels or patreons.\u003cbr\u003e\nIf you use this software in production, please consider supporting its development with contributions or [donations](https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=donation%40sipcapture%2eorg\u0026lc=US\u0026item_name=SIPCAPTURE\u0026no_note=0\u0026currency_code=EUR\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest)\n\n[![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=donation%40sipcapture%2eorg\u0026lc=US\u0026item_name=SIPCAPTURE\u0026no_note=0\u0026currency_code=EUR\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest) \n","funding_links":["https://github.com/sponsors/qxip","https://bunq.me/qxip","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=donation%40sipcapture%2eorg\u0026lc=US\u0026item_name=SIPCAPTURE\u0026no_note=0\u0026currency_code=EUR\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest"],"categories":["Contribution Guidelines"],"sub_categories":["HEP Server Applications"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsipcapture%2Fheplify-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsipcapture%2Fheplify-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsipcapture%2Fheplify-server/lists"}