Install Host Agent

Install the Host Agent on servers and workstations you want in the CMDB. Deployment is typically handled by your IT team using the same tools you use for other endpoint software (GPO, Microsoft Intune, Ansible, or manual install).

Before you start

Item	Details
Site	Each enrollment key is scoped to a site in Monozu Cloud
Enrollment key	Generated by a tenant administrator; time-limited
Network	Outbound HTTPS to `api.cloud.monozu.io` (and local LAN access to the edge appliance when present)
Approval	After install, agents appear as pending until approved — Approve Host Agents

1. Generate an enrollment key

Sign in to https://cloud.monozu.io as a tenant administrator.
Open Settings and navigate to Host Agents (or Sites → Host enrollment for your tenant build).
Select the target site.
Click Generate enrollment key. Copy the key immediately — it may not be shown again.
Note the key expiry. Generate a new key if rollout is delayed beyond the validity window.

2. Windows installation

Interactive (pilot)

Download the Host Agent MSI from the distribution channel Monozu provides for your tenant.
Run the installer. When prompted, enter the enrollment key and confirm the site.
Complete the wizard. The service starts automatically.

Silent rollout (GPO / Intune)

Use your standard software deployment with the enrollment key supplied as an installer property or environment variable:

ENROLLKEY=<your-enrollment-key>

Exact MSI properties are documented in the package readme from Monozu. Test on a pilot machine before wide deployment.

3. Linux installation

Install the package Monozu provides (.deb or .rpm for your distribution).
Set the enrollment key in the agent configuration file or environment:
Terminal window
```
export ENROLLKEY=<your-enrollment-key>
```
Enable and start the systemd service:
Terminal window
```
sudo systemctl enable --now monozu-host-agent
```

Adjust service name if your package uses a different unit name from Monozu delivery notes.

4. Verify installation

On the host: confirm the agent service is running.
In Monozu Cloud: open Settings → Host Agents → Pending (or equivalent) — the host should appear within a few minutes.
Approve the host to begin inventory uploads.

Troubleshooting

Symptom	What to try
Host not in Pending list	Check outbound HTTPS to `api.cloud.monozu.io`; verify key not expired
Install fails	Confirm OS version supported; check installer logs on the host
Service stops	Review host logs; contact Monozu support with site and hostname

See Troubleshooting for more scenarios.