Latest release · All releases · Installation guide
NetRatel is a self-hosted application for managing computers and automating work across them. Connect machines, view their status, run scripts and jobs, open remote terminals, browse files, and inspect logs from one web interface.
Built with .NET and Akka.NET for real-time coordination, NetRatel includes an API, command-line tools, a native Client/agent, and optional Model Context Protocol (MCP) integrations. AI services are optional and are not required for normal operation.
Published releases include native Client archives, CLI and MCP tooling, and a Compose bundle with verified image digests. Choose a completed release and use its matching downloads, checksums and installation instructions.
- Web provides the browser interface and authenticated operator sessions.
- API owns durable PostgreSQL state, authorization, and the agent gateway.
- CLI, stdio MCP, and HTTP MCP provide separately authorized automation interfaces.
- Client is the native agent installed on managed machines.
- RatelDesk connector provides tenant-scoped protected configuration and preview for monitoring flows; see Monitoring flows.
Choose login method: Local, SSO, or both.
PostgreSQL is the only supported application and identity database. Persist Data Protection and agent-signing material outside the container filesystem. A fresh local installation can use its built-in local accounts with no external identity provider; configure OIDC only for an optional OIDC or hybrid deployment. Supply all secrets at deployment time; the tracked configuration contains only reserved example values.
Read self-hosting before deployment. Obtain the public release bundle from a completed GitHub release and verify its checksums. The bundle supplies immutable image digests after publication has completed. See supported platforms for the current distribution targets and runtime requirements.
Useful references: architecture,
configuration, CLI and MCP,
Native Client, Services inventory, Monitoring, Monitoring flows,
development and testing,
troubleshooting, and
release engineering. The generated API reference
is available at /api/docs/ on a running deployment.
The repository pins its SDK in global.json. Restore, build, and test with:
dotnet restore NetRatel.sln
dotnet build NetRatel.sln --configuration Release --no-restore
bash tools/ci/run-fast-regressions.sh TestResults/fasttools/ci/verify-product-version.sh verifies that all first-party projects
evaluate to the release-manifest version.
Required CI runs fast unit, component and focused API/PostgreSQL regressions after one restore/build. Full product-pair checks, physical incidents, native client execution, browser acceptance and deployment/upgrade checks are opt-in through the manual integration workflow. See release validation for selecting one functional suite and interpreting pending owner acceptance.
See CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md. NetRatel is licensed under Apache-2.0; see LICENSE and NOTICE.
Browse the documentation index for categorized operator, integration, HTTP MCP and historical guides.