Skip to content

omnicate/homer-app

 
 

Repository files navigation

HOMER WebApp

This repository hosts homer-app, the the GO webapplication for the HEP/HOMER 7.7+ stack.

Instructions

Requirements

  • golang 1.13+
  • postgres 12+
  • optional
    • prometheus
    • influxdb
    • loki

Installation

Local

To get dependencies and compile the latest homer-app on your system, use the following commands:

make modules
make all
Docker

To get dependencies and compile the latest homer-app using a docker builder, use the following command:

make binary
make frontend

Configuration

Before using the application, configure all database parameters using the example configuration file:

/usr/local/homer/webapp_config.json

NOTE: The default location for settings and provisioning files is /usr/local/homer

Usage

Command Help
./homer-app -h
Custom Config in /etc
./homer-app -webapp-config-path=/etc
Initialization

The application is able to initialize its database and tables it requires with the following commands:

Create User
./homer-app -create-homer-user -database-root=postgres -database-host=localhost -database-root-password=postgres
Show User
./homer-app -show-db-user -database-root=postgres -database-host=localhost -database-root-password=postgres
Create User permissions
./homer-app -create-homer-role -database-root=postgres -database-host=localhost -database-root-password=postgres -database-homer-data=homer_data -database-homer-config=homer_config
Create Homer DBs
./homer-app -create-config-db -database-root=postgres -database-host=localhost -database-root-password=postgres -database-homer-user=homer_user
./homer-app -create-data-db -database-root=postgres -database-host=localhost -database-root-password=postgres -database-homer-user=homer_user
Create Table / Migration - connection data will be read from webapp_config.json
./homer-app -create-table-db-config 
Populate DB
./homer-app -populate-table-db-config 

DEB, RPM Packages

To build a full package, including the latest frontend code:

make package

The application will deploy to /usr/local/bin with config in /etc

Docker Image

This application is available on dockerhub as sipcapture/webapp To build a full bundle locally, including the latest frontend code:

make docker

For further examples, refer to the docker folder


This project is part of HOMER


License & Copyright

This project is released under the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

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

Donate

(C) 2008-2020 QXIP BV

About

HOMER 7.x Front-End and API Server

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 97.6%
  • Shell 2.0%
  • Other 0.4%