Zeron

Fast, Lightweight Windows Remote Automation for Internal Networks.

Driven by NetMQ (ZeroMQ), Zeron empowers SMB IT teams and developers to control systems, deploy software, and build task pipelines via clean JSON-RPC APIs.

• ⚡ Ultra-Lightweight: Built on NetMQ (ZeroMQ) for high-performance, low-latency messaging.
• 🛡️ Private & Secure: Designed specifically for internal networks and SMB environments — no cloud required.
• 🔌 Developer-Friendly: Exposes standard JSON-RPC APIs for full control over deployments, scheduling, and pipelines.
• ⚙️ Always-On Reliable Agent: Runs seamless background management via Zeron.Demand Windows Service.

• NetMQ REQ/REP — JSON RPC on port 5589
• NetMQ PUB — Event stream on port 5588 (install, task, filesystem, etc.)
• NetMQ SUB — Remote push commands via RemoteCommand handler
• ManagedPackage — SQLite-driven software install/uninstall
• Scheduler — NCrontab cron tasks via Resource/scheduler-tasks.json
• Task Pipeline — JSON-defined multi-step workflows
• Agent Identity — Persistent AgentId + HealthCheck API
• API Scopes — RBAC via zmq_rep_api_scopes config
• Audit Log — SQLite audit trail at Resource/audit.db
• Zeron.Server — Central HTTP API + NetMQ command PUB for multi-agent management
• Dashboard — Blazor Server UI with JWT/Cookie auth and role-based access
• Offline Alerts — Automatic agent.offline alerts with optional email notification
• User Management — Admin CRUD for Admin / Operator / Viewer accounts
• Password Policy — Forced change on first login + self-service change password
• Dashboard Summary — Home overview of agents, tasks, alerts, and events with live refresh
• Task Schedules — Central cron schedules that dispatch remote APIs to agents
• Package Deploy — Central ManagedPackage install/uninstall to selected agents
• Health Probes — /health and /ready for deployment monitoring
• Windows Service — Zeron.Server and Zeron.Demand can run as Windows Services

Building requires Visual Studio 2026 Community and test under Windows 11.

dotnet build Zeron.sln -c Release
dotnet test Zeron.sln -c Release

CI on GitHub Actions builds, tests, and publishes deploy zips (zeron-server-win-x64, zeron-agent-win-x64). Push a v* tag to create a GitHub Release with the same packages. See Docs/deployment.md.

Run the agent:

dotnet run --project Zeron.Demand

Run the test client:

dotnet run --project Zeron.Client

Run the central server:

dotnet run --project Zeron.Server

Default Dashboard: http://localhost:5000 (admin / admin123 in Development).

Detailed guides are in the Docs/ directory:

• Deployment Guide — production setup for server and agents
• Configuration Reference — server and agent settings
• Agent Connection Guide — heartbeat, diagnostics, troubleshooting
• Testing Guide — unit tests, E2E tests, EF migrations

Production settings: copy Zeron.Server/appsettings.Production.template.json to appsettings.Production.json and set secrets before deploy.

Resource/scheduler-tasks.json:

{
  "tasks": [
    {
      "name": "daily-serverinfo",
      "cron": "0 8 * * *",
      "enabled": true,
      "steps": [
        { "type": "api", "apiName": "ServerInfo", "command": "" }
      ]
    }
  ]
}

Copyright (c) 2017-2026 Ji-Feng Tsai.
Code released under the MIT license.

If this application help you reduce time to coding, you can give me a cup of coffee :)

Paypal Me