Skip to content

simple, beautiful & fully-responsive local network monitoring

License

Notifications You must be signed in to change notification settings

Miosame/flatline

Repository files navigation

flatline

simple, beautiful & fully-responsive local network monitoring

image

requirements

  1. docker & docker-compose: https://www.digitalocean.com/community/tutorials/how-to-install-docker-compose-on-ubuntu-18-04

variables explained

This section explains the variables that are of interest inside .env

  • DASHBOARD_REFRESH = refreshes the index page every X seconds (set to 0 to deactivate)
  • HTTP_PORT = port on which the dashboard will be reachable on
  • SCAN_DNS_SERVER = change this if your router supports local dns, value is the IP of your router, e.g. 192.168.0.1
  • SCAN_INTERVAL = how often a local network scan should happen, value in seconds (300 by default)
  • SCAN_RANGE = the network range that should be scanned, possible formats are:
    • "192.168.0.2-192.168.0.254"
    • "192.168.1.134/29"
  • DB_PORT_CUSTOM = if you have another mysql database listening on port :3306, then for now you want to change it here to another port, more details: #7 - in the future that might not be necessary.

instructions

  1. git clone --depth=1 https://github.com/Miosame/flatline.git
  2. make sure you are in the new directory cd flatline/
  3. change all values marked as XXX inside .env
  4. chmod +x ./install.sh && ./install.sh
  5. wait for it to finish and it'll by default expose to http://localhost
  6. now depending on what value you've set for SCAN_INTERVAL - wait for one rotation of that interval and shortly after all your local devices should show up in the dashboard

notes

You can see actively planned / confirmed TODOs in projects, if it isn't listed, please feel free to open a new issue describing your idea and if it fits the project, I will add it in.

If you want to contribute, know that this project is based on:

About

simple, beautiful & fully-responsive local network monitoring

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published