README.md

Prerequisites

• Docker
• Docker-compose

# Installs also Docker (as a dependency)
sudo apt install docker-compose

• User is a member of docker group

# Is user already a member?
groups | grep docker
... docker

# If not, add him
sudo adduser $USER docker

# Launch new shell, so group change above takes effect
# Alternatively, logout and login 
su - $USER

Installation

git clone https://github.com/dNationCloud/ping.git
chmod a=rwx ping/docker/prometheus/prometheus

Changing defaults (optional)

• docker/.env - website access information
• docker/prometheus/targets.json - ping targets
  • For measuring a home connection also include your router (usually 192.168.1.1) as a ping target, useful for detection of problems with the router itself (should be always reachable)

# After editing
docker-compose restart prometheus
docker-compose logs prometheus
ping-prometheus | level=info ts=2021-01-10T22:30:56.937Z caller=main.go:918 msg="Completed loading of configuration file" filename=/etc/prometheus.yaml

Launch

# Launch
cd ping/docker
docker-compose up -d

# Debug
docker-compose logs | grep ERROR

Getting started

After installation:

• http://localhost:3001/
• Username: admin
• Password : pass
• Click Ping dashboard
• If you want to set the Ping dashboard as a home dashboard, follow instructions