Install the Windows agent
Deploy the MaelGard agent on Windows 11: silent MSI, public properties, GPO and Intune, post-install checks and removal.
The MaelGard agent for Windows ships as one MSI per architecture. It carries the service, the session agent, the UI, the admin tool, the WFP driver and the minifilter. A single MSI covers the whole endpoint.
Prerequisites
- System: Windows 11 version 22H2 or newer, Pro, Enterprise or Education edition.
- Architecture: x64 or ARM64. One MSI per architecture.
- Runtime: .NET 10 Desktop Runtime for the UI (installed by the MSI if missing).
- TPM: TPM 2.0 recommended for the non-exportable client key. CNG software with SYSTEM ACL as fallback.
- Memory integrity (HVCI): supported by the signed driver.
- Account: local administrator rights for installation.
Delivered files
| File | Purpose |
|---|---|
Maelgard-<version>-x64.msi | Complete agent for x64 endpoints. |
Maelgard-<version>-arm64.msi | Complete agent for ARM64 endpoints. |
DLPIA.admx, DLPIA.adml | ADMX and ADML templates for GPO and Intune (French, English). |
gateway-root.pem | Gateway root to pin via the SERVER_CA property. |
Silent install
From an elevated PowerShell console, the unattended install uses msiexec /qn with public properties.
$msi = 'C:\Deployment\Maelgard-0.1.0-x64.msi'
$caPem = 'C:\Deployment\gateway-root.pem'
$log = 'C:\Deployment\install.log'
$serverCa = [Convert]::ToBase64String([IO.File]::ReadAllBytes($caPem))
Start-Process msiexec.exe -Wait -PassThru -ArgumentList @(
'/i', $msi, '/qn', '/l*v', $log,
"SERVER_URL=https://gateway.example.local:28443",
"TENANT_ID=<tenant-id>",
"ENROLL_TOKEN=<fresh-token>",
"SERVER_CA=$serverCa"
)Exit code 0 means success. The service starts and attempts enrollment in the background.
MSI public properties
| Property | Required | Purpose |
|---|---|---|
SERVER_URL | Yes | MaelGard gateway URL, for example https://gateway.example.local:28443. |
TENANT_ID | Yes | Customer tenant identifier (UUID). |
SERVER_CA | Yes | Gateway root in PEM, base64-encoded on a single line. |
ENROLL_TOKEN | Yes | Single-use enrollment token. |
CONFIG_PUBKEY | No | Ed25519 public key of the tenant configuration signer. Pre-loaded if provided, otherwise delivered by enrollment. |
UNINSTALL_TOKEN | No | Token required for uninstall. Guards against unauthorized removal. |
BROWSER_POLICIES | No | 1 deploys Edge/Chrome/Firefox policies (QUIC, ECH, DoH, Firefox roots). Default: 1. |
CA_MODE | No | local (default) or enterprise. Picks the inspection CA source. |
CHANNELS | No | List of channels active at install. Default: web channels active, others in observe. |
ALLUSERS | No | Always 1 (per-machine install). Set by the MSI, no need to pass. |
Deploy with GPO
- Copy
DLPIA.admxandDLPIA.admlto the domain Central Store (\\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions). - In the Group Policy Management Console, create a GPO linked to the target OU.
- Open Computer Configuration -> Policies -> Administrative Templates -> MaelGard and set the parameters.
- In Computer Configuration -> Policies -> Software Settings -> Software installation, publish the MSI for the computer.
- Apply and verify with
gpupdate /forceon a test endpoint.
| Category | Registry path |
|---|---|
| Administration | HKLM\SOFTWARE\Policies\DLPIA |
| Analysis | HKLM\SOFTWARE\Policies\DLPIA |
| Catalog | HKLM\SOFTWARE\Policies\DLPIA |
| Categories | HKLM\SOFTWARE\Policies\DLPIA |
| Channels | HKLM\SOFTWARE\Policies\DLPIA |
| Diagnostics | HKLM\SOFTWARE\Policies\DLPIA |
| Interception | HKLM\SOFTWARE\Policies\DLPIA |
| Policy | HKLM\SOFTWARE\Policies\DLPIA |
| Storage | HKLM\SOFTWARE\Policies\DLPIA |
| Sync | HKLM\SOFTWARE\Policies\DLPIA |
| UI | HKLM\SOFTWARE\Policies\DLPIA |
| Update | HKLM\SOFTWARE\Policies\DLPIA |
Deploy with Intune
Win32 app
- Wrap the MSI with
IntuneWinAppUtil.exeto produce a.intunewinfile. - In Intune, create a Win32 app and import the
.intunewin. - Install command:
msiexec /i Maelgard-<version>-x64.msi /qn SERVER_URL=... TENANT_ID=... ENROLL_TOKEN=... SERVER_CA=.... - Uninstall command:
msiexec /x <ProductCode> /qn UNINSTALL_TOKEN=.... - Detection rule: MSI product code.
- Assign to a device group and let Intune push the install.
ADMX import
Under Devices -> Manage devices -> Configuration -> Import ADMX, import DLPIA.admx and the matching .adml. Settings appear in a Templates -> Imported administrative templates profile.
OMA-URI
Parameters can also be pushed via OMA-URI with the prefix ./Device/Vendor/MSFT/Policy/Config/DLPIA~Policy~<category>/<parameter>. Use this path for a single setting; prefer ADMX for a full configuration.
Post-install checks
From an elevated PowerShell console, verify the service, drivers and enrollment.
$admin = "$env:ProgramFiles\MaelGard\dlpia-admin.exe"
Get-Service DlpIa
sc.exe query DlpIaWfp
sc.exe query DlpIaFlt
& $admin status | ConvertFrom-Json | ConvertTo-Json -Depth 8- Service
DlpIain stateRunning. - Driver
DlpIaWfpin stateRUNNINGand minifilterDlpIaFltloaded. - In
dlpia-admin status:driver.loaded=true,driver.service_alive=true, at least one entry indriver.listen. enrollment.device_idandenrollment.not_afterpresent.- Folder
%ProgramData%\MaelGard\created, readable by SYSTEM only. - Local CA
DLP-IApresent inCert:\LocalMachine\Root.
Uninstall
Start-Process msiexec.exe -Wait -PassThru -ArgumentList @(
'/x', 'C:\Deployment\Maelgard-0.1.0-x64.msi',
'/qn', '/l*v', 'C:\Deployment\uninstall.log',
"UNINSTALL_TOKEN=<token>"
)Uninstall removes services, drivers and the local CA. It sends a final event to the server if a connection is available. Endpoint data stays under %ProgramData%\MaelGard\ unless purge is requested.
Purge local data
To also remove data, logs and downloaded models, add PURGE=1 to the properties on the msiexec /x line. Any un-reported events are lost.
Install troubleshooting
| Code | Meaning | Action |
|---|---|---|
0 | Success. | Verify with dlpia-admin status. |
1603 | Fatal error during install. | Read the log passed to /l*v, search for Return value 3. |
1618 | Another installation is in progress. | Wait for the other installer and retry. |
1622 | Cannot open the log file. | Create the log parent folder before the command. |
1625 | Installation forbidden by policy. | Check AppLocker or SRP restrictions. |
3010 | Success, reboot required. | Reboot to complete the service bring-up. |
| Symptom | Check and action |
|---|---|
Driver DlpIaWfp not loaded. | Check signing certificate and HVCI. On internal evaluation: Secure Boot disabled and test mode active. |
| Enrollment refused 401. | Token expired, exhausted or wrong tenant. Mint a new token for the exact tenant and retry. |
ca_removed alert at startup. | Another product removes the CA. Check antivirus and cleaners. The CA is reinstalled automatically. |
MSI log 1922 or 1923. | Service DlpIa cannot be created or started. Ensure no leftover install exists and retry. |
| Edge shows a certificate error on an AI site. | Check driver.loaded=true and the CA under Cert:\LocalMachine\Root. Restart Edge. |
Invalid config signature, policy_version=0 on the console. | Signer public key missing from the keyring. Reinstall against a fresh enrollment or pass CONFIG_PUBKEY to the MSI. |
Detailed logs live under %ProgramData%\MaelGard\logs\service.log and in the MSI log passed to /l*v. Open them in a text editor and search for ERROR and WARN.