🖥️ 5 Minute Linux Live Watcher

5 Minute Watcher is a lightweight, self-hosted system monitoring tool built with Python, Flask, WebSockets, and Chart.js.

It provides real-time system metrics (CPU, memory, disk, etc.) in a clean web dashboard, updating every second and retaining up to the last 5 minutes of data.

http://localhost:5000 || http://machine-ip:5000

---

🚀 Features

• 🔄 Real-time graphs of:

  • CPU usage & temperature
  • Memory & swap
  • Disk usage
  • Network I/O
  • Uptime
  • System load (1m, 5m, 15m)
  • Total running processes

• 🕒 Retains the last 5 minutes of history (300 data points)

• 🖼️ Live values displayed alongside each chart

• 📊 Easy to use UI

• 🐳 Fully containerized

---

📦 Quick Start

1. Clone the repository:

   git clone https://github.com/aranbarri/five-minute-watcher.git
   cd five-minute-watcher

2. Start the app:

   docker compose up -d 

3. Open your browser at:

   http://localhost:5000
   

   or

   http://<machine-ip>:5000
   

---

🛠 Requirements

• Docker
• Docker Compose

No other system configuration is required.

---

📁 Project Structure

five-minute-checker/
├── watcher.py              # Flask + SocketIO backend
├── templates/
│   └── dashboard.html      # Frontend UI (Chart.js)
├── requirements.txt        # Python dependencies
├── Dockerfile              # App image definition
├── docker-compose.yml      # Full stack setup

---

💡 Customization

• Add or remove metrics in watcher.py
• Modify graph behavior/style in dashboard.html
• Adjust retention time by changing the maxPoints value

---

Screenshots