MaelGard documentation
Complete product guide: overview, concepts, installation, admin console, policies, API reference, troubleshooting. Grounded in the internal manuals and the product specification.
Get started
Overview
MaelGard is a local checkpoint between your devices and generative AI services. The agent inspects outbound requests before they are sent, so the decision stays with you.
Concepts
Key notions for reading the console and events: checkpoint, 4 outcomes, catalogue, channels, categories, policies.
Deploy
Install the Windows agent
Deploy the MaelGard agent on Windows 11: silent MSI, public properties, GPO and Intune, post-install checks and removal.
Install the Linux agent
Deploy the MaelGard agent on desktop Linux: session Flatpak, systemd host payload, nftables redirection, enrollment and license import.
Install the Android agent
AndGuard 0.1.2 in preproduction: Android 10 and later, APK installation, setup (local VPN, certificate), enrollment and limits.
Install the macOS agent
Status of the macOS port: milestone M0, no deliverable. Planned components, architecture choices, Apple signing and notarization path.
Operate
Admin console
A full tour of the MaelGard admin console, screen by screen, for tenant admins, security admins, DPOs, analysts, device operators and auditors.
Policy and catalog
MaelGard policy format, AI service catalog, data categories, detection models, two-eyes review and signed publication.
Troubleshooting
Messages from the console and the agent, what they mean and how to respond. Followed by known functional limits of the Windows and Linux agents.
Reference
Events and audit log
JSON schema of usage events, HMAC integrity chain, Windows DLPIA/Security log, local retention and SIEM export. No sensitive value is ever stored.
License model
Ed25519 JWS license format, offline verification by agent and server, grace and offline days, revocation. Never any network dependency to check an entitlement.
Agent and server API reference
Interfaces between the agent and the aggregation server, mTLS authentication, /api/v1/* endpoints, zstd NDJSON format, signed JWS catalog and config, BLOB models.
Frequently asked questions
Recurring questions from security teams and administrators. Answers favour technical precision over marketing brevity.