I'm using a lot of self-hosted apps, both at work and in my homelab. Of course, I can't remember all ports taken by those apps. So, the idea of ports inventory seems reasonable.
Why
Why not just use Portainer or other Docker tool?
- Not all apps are hosted in
Docker
. Some things must be run assystemd
services. - Port may be exposed in
Docker
, but blocked by firewall. - There may be ports exposed to the world, you are not aware of.
So, the purposes of WatchYourPorts are:
- Inventory
- Security
- Monitoring
Monitoring is the last one, because it's not the main purpose of this app. There are already tools for that. WatchYourPorts
can do simple port scan on timer and export data to InfluxDB2/Grafana
.
Details
- No DB, all config is stored in two
yaml
files. - All configuration can be done through
ENV
variables,yaml
orGUI
. -
Docker
images forarm/v6
,arm/v7
,arm/arm64
. - Binary releases for many platforms.
- Export to
InfluxDB2
, which allows building aGrafana
dashboard. - Simple API to get data from
WatchYourPorts
.
How
Full installation guide is available in the README file. The easiest way to try it:
docker run --name wyp \
-e "TZ=$YourTimeZone" \
-v ~/.dockerdata/WatchYourPorts:/data/WatchYourPorts \
-p 8853:8853 \
aceberg/watchyourports
Top comments (0)