Skip to content

Commit 1f0b1a5

Browse files
committed
Add LICENSE, root README, and CI workflow
- MIT license - Root README.md for the GitHub landing page (was falling back to rendering docs/README.md with no root README present) - GitHub Actions workflow: build + test on every push/PR to main
1 parent 3f6243e commit 1f0b1a5

3 files changed

Lines changed: 109 additions & 0 deletions

File tree

.github/workflows/ci.yml

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
branches: [ main ]
6+
pull_request:
7+
branches: [ main ]
8+
9+
jobs:
10+
build:
11+
runs-on: windows-latest
12+
steps:
13+
- uses: actions/checkout@v4
14+
15+
- name: Setup .NET
16+
uses: actions/setup-dotnet@v4
17+
with:
18+
dotnet-version: '8.0.x'
19+
20+
- name: Restore
21+
run: dotnet restore
22+
23+
- name: Build
24+
run: dotnet build --no-restore --configuration Release
25+
26+
- name: Test
27+
run: dotnet test tests/OpsCommandCenter.Server.Tests/OpsCommandCenter.Server.Tests.csproj --no-build --configuration Release

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 unupunct
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# OpsCommandCenter
2+
3+
[![CI](https://github.com/unupunct/OpsCommandCenter/actions/workflows/ci.yml/badge.svg)](https://github.com/unupunct/OpsCommandCenter/actions/workflows/ci.yml)
4+
[![Release](https://img.shields.io/github/v/release/unupunct/OpsCommandCenter)](https://github.com/unupunct/OpsCommandCenter/releases/latest)
5+
[![License: MIT](https://img.shields.io/github/license/unupunct/OpsCommandCenter)](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

Comments
 (0)