https://github.com/mishankov/simple-system-monitor

🔢 See your server resourses on simple web UI
https://github.com/mishankov/simple-system-monitor

docker golang monitoring self-hosted selfhosted svelte

Last synced: about 10 hours ago
JSON representation

🔢 See your server resourses on simple web UI

• Host: GitHub
• URL: https://github.com/mishankov/simple-system-monitor
• Owner: mishankov
• License: mit
• Created: 2024-12-18T21:44:43.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2025-02-03T06:37:44.000Z (13 days ago)
• Last Synced: 2025-02-03T07:33:02.635Z (13 days ago)
• Topics: docker, golang, monitoring, self-hosted, selfhosted, svelte
• Language: Go
• Homepage:
• Size: 242 KB
• Stars: 20
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Simple System Monitor

[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/mishankov/simple-system-monitor/ci.yml)](https://github.com/mishankov/simple-system-monitor/actions/workflows/ci.yml)

[![codecov](https://codecov.io/gh/mishankov/simple-system-monitor/graph/badge.svg?token=SACQUDDX8R)](https://codecov.io/gh/mishankov/simple-system-monitor)

[![GitHub Release](https://img.shields.io/github/v/release/mishankov/simple-system-monitor?display_name=tag&label=latest%20release)](https://github.com/mishankov/simple-system-monitor/releases/latest)

[![GitHub License](https://img.shields.io/github/license/mishankov/simple-system-monitor)](https://github.com/mishankov/simple-system-monitor/blob/main/LICENSE)

![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/mishankov/simple-system-monitor)

![GitHub package.json dev/peer/optional dependency version](https://img.shields.io/github/package-json/dependency-version/mishankov/simple-system-monitor/dev/svelte?filename=webapp%2Fpackage.json)

---

See your server resourses on simple web UI

![screenshot](images/screenshot.jpg)

## Setup

### Docker Compose

Simple Docker Compose service looks like this

```yaml

simple-system-monitor:

  image: ghcr.io/mishankov/simple-system-monitor:latest

  container_name: simple-system-monitor

  ports:

    - 4442:4442

  environment:

    - SSM_PATH="/hostfs/proc"

  volumes:

    - /:/hostfs:ro

  restart: 'unless-stopped'

```

### Binary

Download latest `simple-system-monitor` binary from [latest GitHub release](https://github.com/mishankov/simple-system-monitor/releases/latest), unzip it and run

```shell

wget http://github.com/mishankov/simple-system-monitor/releases/latest/download/simple-server-monitor.zip

unzip simple-server-monitor.zip

./simple-server-monitor

```

## Configuration

Configuration of `simple-system-monitor` is done with environment variables. Available env vars:

- `SSM_PERIOD` - period for updating all monitoring in seconds. Default is `2`

- `SSM_PATH` - path to take system information from. Default is `/proc`

- `SSM_PORT` - port to run web server. Default is `4442`

- `SSM_CPUINFO_PERIOD` - period for updating CPU monitoring in seconds. Default is `SSM_PERIOD` value

- `SSM_CPUINFO_PATH` - path to take CPU information from. Default is `SSM_PATH` value + `/stat`

- `SSM_MEMINFO_PERIOD` - period for updating RAM monitoring in seconds. Default is `SSM_PERIOD` value

- `SSM_MEMINFO_PATH` - path to take RAM information from. Default is `SSM_PATH` value + `/meminfo`

- `SSM_UPTIME_PERIOD` - period for updating uptime monitoring in seconds. Default is `SSM_PERIOD` value

- `SSM_UPTIME_PATH` - path to take uptime information from. Default is `SSM_PATH` value + `/uptime`