Public | Automated Build

Last pushed: 4 months ago
Short Description
This image is provided to allow you just map in your own hostnames.txt file.
Full Description


Python script to generate material design html report of devices' online/offline status. A cheap/fun reporting solution.
This can be used for for servers, networking equipment, IOT devices, anything that's "pingable".

  • Linux
  • Windows
  • Raspberry Pi

Live Demo:


  • (6/3/2017) Now providing a docker image instead of building your own
  • (5/27/2017) - Please see for extended functionality.
    • Integrated SQLite DB, all controlled via web UI, API functionality to return JSON.
  • (5/6/17) Added validation of OS for script to run
  • (2/26/17) Update Easy Install to automatically install packages
  • (2/25/17) Added support for vertically scrolling table, adjusts circle size if on mobile device.
  • (2/24/17) Combined ping function to single file, added ability to check other ports. Also converted script to be more in line with python norms. Table rows now act as hyperlinks to address listed and will auto detect port if specified.
  • (2/20/17) Updated noty,jquery, notifications UI, mobile UI
  • (2/18/17) Added support to build custom docker container
  • (2/4/17) Easy Install script now supports Node.js, update wheel color
  • (2/3/17) Change status from online/offline text to colored orb indicators

Easy Install

bash -c "$(curl -sL"

  • Either Node.js or Apache and Python required for Easy Install
  • Tested with Ubuntu 16.04 / Apache 2.4.18 / Node.js 4 / Python 2.7
  • Follow the prompts!


  • Have a text file with hostnames or ip addresses (optional: if port is desired seperate by comma. example:, 80)
  • Update the python script (variable at the top) with the path/name of your file with hostnames and output file path.(default hostames= hostnames.txt default output= index.html)
  • Run python
  • Ensure that you place the output HTML file in the project directory so it can find its web dependencies


  • Setup a web server
  • Install a new cron job to run the report periodically cd $path/to/project_directory/ && python &> /dev/null
  • Set output path in python script to write out html report to web serving directory such as /var/www/html
  • The page will automatically refresh every 60 seconds to reflect the new report generated by cron


  • docker run -d -p 80:80 -v ~/path/to/your/hostnames.txt:/usr/share/nginx/html/hostnames.txt --name monitor circa10a/device-monitor-dashboard

Build your own docker image:

  • git clone
  • cd Device-Monitor-Dashboard
  • Edit your hostnames.txt file add your website, servers, switches, devices, etc.
  • docker build -t myrepo/monitor .
  • docker run --name device-monitor -d -p 80:80 myrepo/monitor
  • Known issue: Docker for Mac pings any address and returns success giving false results.

Docker Pull Command

Comments (0)