|
| 1 | +# OpsCommandCenter |
| 2 | + |
| 3 | +[](https://github.com/unupunct/OpsCommandCenter/actions/workflows/ci.yml) |
| 4 | +[](https://github.com/unupunct/OpsCommandCenter/releases/latest) |
| 5 | +[](LICENSE) |
| 6 | + |
| 7 | +A self-hosted, LAN-only RMM-style dashboard. Agents on Windows, Linux, and Android report |
| 8 | +hardware/health telemetry to a central Server, which stores it and pushes live updates to a |
| 9 | +Blazor dashboard over SignalR. No cloud, no subscriptions, nothing leaves your network. |
| 10 | + |
| 11 | +``` |
| 12 | +Windows Agent \ |
| 13 | +Linux Agent >-- HTTP/heartbeat --> Server (ASP.NET Core + PostgreSQL + SignalR + Dashboard) |
| 14 | +Android Agent / (Ubuntu VM on Proxmox, or anywhere) |
| 15 | + | |
| 16 | + Browser (LAN) |
| 17 | +``` |
| 18 | + |
| 19 | +Every agent speaks the same plain HTTP+JSON heartbeat to the same `/api/heartbeat` endpoint — |
| 20 | +the Server doesn't care which platform sent it. |
| 21 | + |
| 22 | +## Quick start |
| 23 | + |
| 24 | +1. Grab the latest release: **[Releases](https://github.com/unupunct/OpsCommandCenter/releases/latest)** |
| 25 | +2. Stand up the Server — [Ubuntu/Proxmox deployment guide](docs/server-deployment-ubuntu.md) |
| 26 | +3. Install an agent on each device you want to monitor: |
| 27 | + - [Windows](docs/agent-installation.md) — self-installing exe, runs as a Windows service |
| 28 | + - [Linux](docs/linux-agent-installation.md) — self-installing binary, runs as a systemd service |
| 29 | + - [Android](docs/android-agent-installation.md) — a Termux script, no APK/SDK required |
| 30 | + |
| 31 | +Full documentation index: **[docs/README.md](docs/README.md)** |
| 32 | + |
| 33 | +## What it looks like |
| 34 | + |
| 35 | +Enterprise dark-theme dashboard: a stats row (total/healthy/warning/critical/offline devices, |
| 36 | +average disk health), and one status-colored card per device (green/yellow/red/gray) showing |
| 37 | +OS, CPU, RAM, disk health, BitLocker/encryption and antivirus status, battery (mobile), uptime, |
| 38 | +and last-seen time — updating live over SignalR as agents report in. |
| 39 | + |
| 40 | +## Project status |
| 41 | + |
| 42 | +This is a working vertical slice, not the full product vision yet. Working today: live |
| 43 | +telemetry collection and reporting from all three platforms, real-time dashboard with automatic |
| 44 | +offline detection. Deliberately not built yet: authentication, bulk actions, remote tools |
| 45 | +(RDP/PowerShell/VNC), alerts/notifications, per-device notes/tasks, and Proxmox VM monitoring |
| 46 | +alongside physical devices — see [docs/README.md](docs/README.md) for the full scope and known |
| 47 | +limitations, including which platforms have actually been verified on real hardware. |
| 48 | + |
| 49 | +## Building from source |
| 50 | + |
| 51 | +```bash |
| 52 | +dotnet build |
| 53 | +dotnet test |
| 54 | +``` |
| 55 | + |
| 56 | +Requires the .NET 8 SDK. Publish scripts for each deployable piece are at the repo root |
| 57 | +(`publish-agent.ps1`, `publish-agent-linux.ps1`, `publish-server-linux.ps1`). |
| 58 | + |
| 59 | +## License |
| 60 | + |
| 61 | +[MIT](LICENSE) |
0 commit comments