Kasa Collector is a Python-based application deployed with Docker that discovers and monitors TP-Link Kasa smart plugs and power strips on your network. It continuously collects energy consumption data and stores it in InfluxDB for visualization with Grafana dashboards.
A live set of dashboards using this Collector are available here for you to explore.
services:
kasa-collector:
image: lux4rd0/kasa-collector:latest
container_name: kasa-collector
network_mode: host
restart: unless-stopped
environment:
# Required - InfluxDB Configuration
KASA_COLLECTOR_INFLUXDB_URL: http://influxdb:8086
KASA_COLLECTOR_INFLUXDB_TOKEN: your-token-here
KASA_COLLECTOR_INFLUXDB_ORG: your-org
KASA_COLLECTOR_INFLUXDB_BUCKET: kasa
# Optional - For newer devices requiring authentication
# KASA_COLLECTOR_TPLINK_USERNAME: your-email@example.com
# KASA_COLLECTOR_TPLINK_PASSWORD: your-passwordFull documentation is available in the docs/wiki directory:
- Getting Started - Initial setup guide
- Configuration - All environment variables
- Supported Devices - Compatible Kasa devices
- Grafana Dashboards - Visualization setup
- Troubleshooting - Common issues and solutions
- FAQ - Frequently asked questions
- How It Works - Technical details
- Automatic device discovery
- Energy monitoring (power, current, voltage, consumption)
- Smart power strip support with individual outlet monitoring
- Docker health checks
- Grafana dashboards included
- Production-ready with graceful shutdown
This project is licensed under the MIT License - see the LICENSE file for details.
- Issues: GitHub Issues
- Author: Dave Schmid (dave@pulpfree.org)
- Live Demo: https://labs.lux4rd0.com/kasa-collector/
Note: This project is not affiliated with TP-Link or Kasa. It's an independent tool for monitoring energy consumption of Kasa smart devices.