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

Real-time monitoring, Docker integration, file browsing, and alert management - all in one interface

View All Screenshots

---

Table of Contents

• 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

View All Screenshots →

---

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!