alibahmanyar/simon repository overview

⁠Github Repo⁠

⁠Simon

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

⁠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

⁠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

⁠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

⁠Key Configuration Options

See the Configuration Reference⁠ for all available options.

Notes:

1. For accesing docker stats, the user account running Simon needs access to the Docker socket (/var/run/docker.sock). This can be achieved by:

   • Using a user that belongs to the docker group
   • Running as root

2. For accurate system information, mount relevant filesystem paths:

   • Mount /etc/lsb-release or similar OS identification files for correct OS detection
   • Mount /sys for hardware, network and process information
   • Mount filesystems you want to monitor (e.g., / as /rootfs) for disk usage statistics

3. The password hash should be provided correctly; pay attention to escaping special characters (like dollar sign) in the hash