rpi-mon

A real-time Raspberry Pi monitoring web application that provides live system metrics through a clean, responsive web interface.

What is rpi-mon?

rpi-mon is a lightweight monitoring solution for Raspberry Pi devices. It displays real-time system information including CPU temperature, memory usage, and hardware details through a modern web dashboard that updates automatically every 5 seconds.

Features

• Real-time monitoring with live updates via web interface
• System information display (OS, hardware, model detection)
• Performance metrics (CPU temperature, memory usage, CPU load)
• Mobile-friendly responsive design with dark/light mode toggle
• No authentication required - perfect for home lab environments
• Docker deployment for easy setup and isolation

Quick Start with Docker Compose

The easiest way to get rpi-mon running on your Raspberry Pi:

1. Clone the repository:

   git clone https://github.com/spindev/rpi-mon.git
   cd rpi-mon

2. Start with Docker Compose:

   docker-compose up -d

3. Access the dashboard: Open your browser and go to http://your-rpi-ip:5000

That's it! The application will automatically detect your Raspberry Pi hardware and start displaying live metrics.

Platform Compatibility

The Docker images are specifically built for Raspberry Pi devices:

• linux/arm64 - For Raspberry Pi 4, Pi 5, and Raspberry Pi 3 with 64-bit OS

Docker will automatically pull the correct image for your Raspberry Pi platform.

Manual Docker Deployment

If you prefer to use Docker directly or build the image from source:

Using the pre-built image:

docker run -d \
  --name rpi-mon \
  -p 5000:5000 \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /etc:/host/etc:ro \
  --privileged \
  ghcr.io/spindev/rpi-mon:latest

Building from source:

docker build -t rpi-mon .

docker run -d \
  --name rpi-mon \
  -p 5000:5000 \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /etc:/host/etc:ro \
  --privileged \
  rpi-mon

System Requirements

• Raspberry Pi (any model: Pi 3, Pi 4, Pi 5, etc.)
• Docker and Docker Compose installed
• Network access to reach the web interface

Configuration

The application works out of the box with no configuration needed. It automatically:

• Detects your Raspberry Pi model
• Monitors system resources
• Provides real-time updates
• Adapts the interface for mobile devices

Troubleshooting

Platform Issues on ARM64 Devices

If you see platform mismatch errors like "exec format error" on Raspberry Pi 5 or other ARM64 devices:

1. Specify platform in docker-compose.yml:

   services:
     rpi-mon:
       image: ghcr.io/spindev/rpi-mon:latest
       platform: linux/arm64  # Add this line
       # ... rest of configuration

2. Build locally instead:

   # Comment out 'image:' line and uncomment 'build:' in docker-compose.yml
   docker-compose build
   docker-compose up -d

3. Use explicit platform flag:

   docker run -d \
     --name rpi-mon \
     --platform linux/arm64 \
     -p 5000:5000 \
     -v /proc:/host/proc:ro \
     -v /sys:/host/sys:ro \
     -v /etc:/host/etc:ro \
     --privileged \
     ghcr.io/spindev/rpi-mon:latest

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.