Simon

<img src="https://github.com/user-attachments/assets/d9214875-d2e5-4a00-8688-e2d435409d7b" width="192" height="192" /> <a href="https://github.com/alibahmanyar/simon/releases"><img src="https://img.shields.io/github/v/release/alibahmanyar/simon?style=for-the-badge" alt="Latest Release"/></a> <a href="https://github.com/alibahmanyar/simon/actions"><img src="https://img.shields.io/github/actions/workflow/status/alibahmanyar/simon/ci.yml?style=for-the-badge" alt="Build Status"/></a> <a href="https://hub.docker.com/r/alibahmanyar/simon"><img src="https://img.shields.io/docker/pulls/alibahmanyar/simon?style=for-the-badge" alt="Docker Pulls"/></a> <img alt="Docker Image Size" src="https://img.shields.io/docker/image-size/alibahmanyar/simon?style=for-the-badge&label=Docker%20image%20size"> <a href="https://github.com/alibahmanyar/simon/blob/main/LICENSE"><img src="https://img.shields.io/github/license/alibahmanyar/simon?style=for-the-badge" alt="License"/></a> A lightweight, all-in-one system monitor with Docker support, live metrics, alerts, and full file management It's a single, dependency-free binary written in Rust, designed for resource-constrained environments like embedded Linux systems

<img src="docs/media/simon.gif" alt="Simon Demo - Live system monitoring interface" width="800"> Real-time monitoring, Docker integration, file browsing, and alert management - all in one interface <a href="docs/SCREENSHOTS.md">View All Screenshots</a>

Features
Quick Start
Documentation
Building from Source
Gallery
License
Acknowledgments

Features

🪶 Lightweight

Written in Rust: For a memory-safe, high-performance core
Single Binary: A self-contained executable with no external dependencies to install or manage
Minimal resource footprint - Perfect for embedded systems and low-power devices

📊 System Monitoring

Real-time metrics - Live tracking of CPU, memory, disk usage, disk I/O, and network activity
Historical data - Visualize trends with interactive charts
Cross-platform - Runs on Linux, Windows, Android, and FreeBSD
Multi-architecture - Native support for x86_64, i686, aarch64, and armv7

🐳 Docker Integration

Container monitoring - Track resource usage for all running containers
Log viewer - Access and search container logs directly from the web interface
Real-time stats - Per-container CPU and memory metrics

📁 File Browser & Management

Filesystem navigation - Browse and explore directories through the web UI
File viewer - Preview file contents directly in your browser
File uploads - Upload files with drag-and-drop support
File operations - Create folders, move files, delete items
File downloads - Range request support for resumable downloads and media streaming

🔔 Alerting System

Flexible alerts - Set custom thresholds for CPU, memory, disk, and network
Multiple channels - Send notifications via Telegram, ntfy, or custom webhooks
Templates - Pre-configured notification templates for quick setup

Quick Start

Option 1: Prebuilt Binary

Download the latest release for your platform from the Releases page and run:

chmod +x simon
./simon

The web interface will be available at http://localhost:30000

To enable file browsing, use either environment variable or CLI flag:

# Using environment variable
export SIMON_SERVE_DIRS="/path/to/dir1,/path/to/dir2"
./simon

# Using CLI flags (can specify multiple directories)
./simon --serve-dir /path/to/dir1 --serve-dir /path/to/dir2

# Custom port and bind address
./simon --port 8080 --address 127.0.0.1 --serve-dir /home --serve-dir /var/log

Option 2: Docker

docker run -d \
  --name simon \
  -p 30000:30000 \
  -v /sys:/sys:ro \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /:/fs:ro \
  -v ./simon-data:/app/simon-data \
  alibahmanyar/simon

To enable file browsing, add the SIMON_SERVE_DIRS environment variable:

-e SIMON_SERVE_DIRS="/fs/home,/fs/var/log"

Option 3: Docker Compose

services:
  simon:
    image: alibahmanyar/simon
    hostname: simon
    ports:
      - "30000:30000"
    environment:
      SIMON_PASSWORD_HASH: "$$2a$$12$$nmCGsgJ3ovx76sc/J8Bcs.Vn235KLQK7Cze83Kzm36a1v59QKVOO."
    volumes:
      - /sys:/sys:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /:/fs:ro
      - ./simon-data:/app/simon-data

Run with: docker-compose up -d

Note: The default password for the example hash is secret. See Authentication for instructions on generating your own secure hash.

To enable file browsing, add SIMON_SERVE_DIRS to the environment section:

environment:
  SIMON_SERVE_DIRS: "/fs/home,/fs/var/log"

Documentation

Comprehensive documentation is available in the docs/ directory:

Setup Guide - Installation methods, Docker configuration, reverse proxy setup, and authentication
Configuration Reference - Complete list of configuration options and environment variables
Alerts and Notifications - Setting up alerts, notification methods, and notification templates

Key Configuration Options

| Option | CLI Flag | Environment Variable | Default | Description | |--------|----------|---------------------|---------|-------------| | Address | -a, --address | SIMON_ADDRESS | 0.0.0.0 | Network address to bind the server to | | Port | -p, --port | SIMON_PORT | 30000 | Server port | | Update Interval | -T, --update-interval | SIMON_UPDATE_INTERVAL | 2 | Metrics refresh interval (seconds) | | Password Hash | -H, --password-hash | SIMON_PASSWORD_HASH | None | Bcrypt hash for authentication | | Database Path | --db-path | SIMON_DB_PATH | ./simon-data/simon.db | SQLite database location | | Serve Directories | --serve-dir | SIMON_SERVE_DIRS | None | Directories for file browser (use flag multiple times or comma-separated env var) |

See the Configuration Reference for all available options.

Building from Source

Simon consists of a Rust backend and a Svelte-based web frontend.

Prerequisites

Rust toolchain (latest stable)
Bun (for building the web frontend)

Build Steps

# Clone the repository
git clone https://github.com/alibahmanyar/simon.git
cd simon

# Setup and build web frontend
make web-setup
make web

# Build Simon
make release

Gallery

<img src="docs/media/screenshots/system.png" alt="System Dashboard" width="45%"> <img src="docs/media/screenshots/network.png" alt="Network Stats" width="45%"> <img src="docs/media/screenshots/docker.png" alt="Docker Integration" width="45%"> <img src="docs/media/screenshots/alerts.png" alt="Alerts & Notifications" width="45%"> <a href="docs/SCREENSHOTS.md">View All Screenshots →</a>

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

Acknowledgments

Simon is built on top of excellent open-source projects:

Backend (Rust)

axum - Web framework
sysinfo - System information
bollard - Docker API client
tokio - Async runtime
rusqlite - SQLite interface

Frontend

Svelte - UI framework
SvelteKit - Application framework
Chart.js - Data visualization
Bun - Build tooling

Thank you to all the contributors and maintainers of these projects!

Happy Monitoring!

Simon

Install / Use

README

Simon

Table of Contents

Features

🪶 Lightweight

📊 System Monitoring

🐳 Docker Integration

📁 File Browser & Management

🔔 Alerting System

Quick Start

Option 1: Prebuilt Binary

Option 2: Docker

Option 3: Docker Compose

Documentation

Key Configuration Options

Building from Source

Prerequisites

Build Steps

Gallery

License

Contributing

Acknowledgments