← Back to listings

system-state

system state

Path: /home/moose/Projects/system-state

Open project Web UI

README

# system-state

Live host metrics dashboard with a detailed, readable web UI.

## Features
- CPU usage and load averages
- Memory usage and pressure metrics
- Root disk usage
- Network byte totals
- Logged-in user sessions (user, tty, idle, active duration)
- Installed package inventory (dpkg summary + sample list)
- Process scheduler stats, interfaces, and mount snapshot
- Uptime, kernel, hostname
- Animated gauges and trend sparklines

## Run
```bash
cd /home/moose/Projects/system-state
npm start
```

Defaults:
- Host: `0.0.0.0`
- Port: `3100`

Environment overrides:
```bash
HOST=127.0.0.1 PORT=3100 npm start
```

## Endpoints
- `/` dashboard UI
- `/api/metrics` JSON metrics
- `/healthz` health check

## Nginx (example location block)
If `listings` is already on `/`, you can expose this app under `/system-state/` with an additional location:

```nginx
location /system-state/ {
    proxy_pass http://127.0.0.1:3100/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}
```