Quick Install

HOMER Setup

This document provides guidance, packages and details to get HOMER installed & running

1. 🎁 Manual Install (easy)
2. 📑 Quick Install (easier)
3. 🐋 Docker Install (easiest)

WORK IN PROGRESS: CURRENTLY BEING UPDATED FOR HOMER 7.7.x - ISSUE REPORTS ARE WELCOME!

---

🎁 Manual Install:

Homer and its components can easily be installed manually in just minutes.

Debian

Install the sipcapture repository for Debian Stretch:

curl -s https://packagecloud.io/install/repositories/qxip/sipcapture/script.deb.sh | sudo bash

Install the latest package

HOMER/HEP Agent

• apt install heplify

HOMER/HEP Server

• apt install heplify-server
• apt install homer-app

CentOS

Install the sipcapture repository for CentOS/EL 7:

curl -s https://packagecloud.io/install/repositories/qxip/sipcapture/script.rpm.sh | sudo bash

HOMER/HEP Agent

• yum install heplify

HOMER/HEP Server

• yum install heplify-server
• yum install homer-app

Quick Configuration

• Configure Homer Capture Server /opt/heplify-server/heplify-server.toml
  • Example Configuration
  • Configure DB connectors
    • Postgres
    • Loki (optional)
    • Prometheus Metrics Endpoint
• Configure Homer Application /usr/local/homer/etc/webapp_config.json
  • Example Configuration
  • Configure DB connectors
    • Postgres
    • Prometheus API (optional)
    • InfluxDB API (optional)
    • Loki API (optional)

---

📑 Quick Install:

A script is provided to deploy the baseline elements with minimal interaction on a vanilla server: https://github.com/sipcapture/homer-installer

Quick install currently supports debian 9 and centos 7 based operating systems.

Instructions

Make sure the script is executed as root on a netinstall vanilla server:

wget https://github.com/sipcapture/homer-installer/raw/master/homer_installer.sh
chmod +x homer_installer.sh
./homer_installer.sh

---

🐋 Docker Install:

A set of docker-compose bundles is provided to bootstrap a full Homer 7.7 deployment including optional elements: https://github.com/sipcapture/homer7-docker

Instructions

This procedure requires docker and docker-compose installed on the target system.

Deployment

git clone https://github.com/sipcapture/homer7-docker
cd homer7-docker/heplify-server/hom7-prom-all
docker-compose up -d

Access & Usage

• Homer:9080 (admin/sipcapture)
• Grafana:3000 (admin/admin)
• Prometheus:9090 (admin/admin)
• Loki:3100 (admin/admin)
• Alertmanager:9093 (admin/admin)

---

Made with ❤️ by Humans

(C) 2008-2020 QXIP BV

---

If you use HOMER in production, please consider supporting the project with a Donation