Wazuh system inventory for IT hygiene

How to use the Wazuh system inventory to track installed software, services, users, groups and browser extensions on endpoints, and how that data feeds vulnerability detection in infrastructure you control.

On this page

Why teams use the Wazuh system inventory for IT hygiene

The Wazuh agent inventory collects installed software, services, users, groups and browser extensions from endpoints and servers, and Wazuh correlates that software inventory with vulnerability data from the Wazuh Cyber Threat Intelligence platform or an offline repository. Teams reach for this when they cannot answer basic questions quickly: which hosts run a given package version, which accounts have local group membership they should not have, and which browser extensions are installed across a fleet. Those questions come up during an incident, before a patch window, and during an audit request for asset evidence.

The feature does not replace a formal asset management or configuration management database process. The agent sees what is installed on a host it can reach. It does not know who owns a system, what business service it supports, when it was procured, or whether it should exist at all. Teams that rely on the inventory for those decisions still need an owner register, a lifecycle process and a way to reconcile agent-reported hosts with cloud accounts, hypervisors and network scans. Plan that reconciliation as a separate piece of work rather than assuming the agent list is complete.

The Wazuh software is open source and distributed under the GNU General Public License version 2, with an exception for linking with OpenSSL. There is no license fee for the self-hosted software. The cost that remains is the infrastructure and people needed to run it. In a self-hosted deployment, the organization operates the Wazuh server, the Wazuh indexer and the Wazuh dashboard, and it deploys and maintains the agents on each endpoint. Confirm the license terms against the LICENSE file in the Wazuh repository with your legal team before you rely on them for a specific use.

Before enabling the inventory across the estate, decide which hosts must report, how long inventory history is retained in the indexer, who can see user and group data, and how inventory findings route to the people who patch systems. Check that every platform in scope is one the agents support, and list the systems that cannot run an agent so they are handled through another route. Confirm with Wazuh which agent versions and server versions you intend to run together, because the inventory and vulnerability data depend on both being current within the 4.14 release line.

Which inventory scope and vulnerability data source fits your environment

This table compares the inventory categories, vulnerability data sources and deployment methods that shape a Wazuh 4.14 inventory build. Read each row against your network access, fleet size and the staff who will triage results. The main takeaway is that the vulnerability data source and deployment method are early decisions, because they determine what your team maintains after go-live.

ChoiceWhen it fitsStaff time to runConfirm in the 4.14 docs
Core categories: software, services, users and groupsBaseline hygiene across servers and endpoints where patch and account review come firstLow to moderate: mostly reviewing inventory results and tuning noisy viewsWhich collectors are enabled by default and the agent-side settings for each category
Browser extensions added to the scopeDesktop fleets where extensions are a known data exposure path that needs regular reviewModerate: browser coverage, extension review and exception handling recurSupported browsers, operating systems and how extension data is collected per user profile
Full inventory across all categoriesTeams that need one searchable view of endpoint state for audits and incident scopingHigher: more data to index, filter and triage, so retention and dashboards need planningIndexer storage impact per category and the recommended inventory scan interval
Vulnerability detection with the Wazuh CTI platformConnected deployments where outbound access to the vendor feed is permittedLow to moderate: feed updates run on their own, but proxy and access reviews recurRequired outbound endpoints, proxy settings and how feed updates are scheduled
Vulnerability detection with an offline repositoryAir-gapped or restricted networks where the vendor feed cannot be reachedHigh: someone must load and refresh the repository on a planned cycleRepository format, how the server loads it and the refresh steps for the release in use
All-in-one installationSingle-node labs, proofs of concept and small estates with one administratorQuick to set up, but scale and upgrade options are narrower than in a clustered layoutSupported size limits and whether this layout is intended for production use
Step-by-step installationProduction deployments where indexer, server and dashboard run on separate hostsModerate to high: each component is installed, secured and joined by handComponent install order, certificate steps and node counts for a clustered server
Docker, Kubernetes or prebuilt imagesTeams already operating container platforms and standard image pipelinesModerate: staff maintain images, persistent volumes and upgrades inside the platformImage tags for the release line, persistent storage needs and supported orchestrator versions
Ansible or Puppet automationEstates where configuration management already governs servers and repeat installsModerate upfront to write and test roles, then lower for repeat installs and upgradesWhich roles the project maintains for the release line and how upgrades run through them

How agents collect the inventory and where it appears in the dashboard

The inventory follows a fixed path through the Wazuh components, and knowing that path tells you where to look when data is missing. A Wazuh agent installed on each endpoint collects system inventory data and sends it to the Wazuh server. The server analyzes the incoming data with decoders, which parse and normalize the records, and with rules, which decide what the records mean. The Wazuh indexer, a full-text search and analytics engine, stores the results, and the Wazuh dashboard reads from the indexer to show them. Each hop is a separate place to check when a host appears to have no inventory.

Because the server manages agent configuration remotely, inventory collection is controlled centrally rather than edited on each machine by hand. Agents run on Linux, Windows and macOS, among other platforms, so one policy model can cover a mixed fleet. A server can also run as a cluster to scale horizontally, which matters once the number of agents grows. Confirm the exact inventory fields each agent version reports and the collection intervals in the documentation for the version you install. Field names and timing can change between releases, and your alerting and dashboard filters depend on them.

IT hygiene teams usually start with a short list of questions the inventory should answer. They look for unexpected software on endpoints, services that should not be running, local users or groups that nobody recognizes, and browser extensions that are not on the approved list. In the dashboard, these become saved views filtered by host group, with each view compared against a baseline your team maintains. The baseline is your responsibility. Wazuh shows what the agents report, but someone must decide which entries are approved, who owns each exception, and how a new item gets reviewed.

Before you roll the inventory out widely, run it on a small test group that includes Windows, Linux and macOS hosts, and check each item on your list against what the dashboard shows. Confirm that browser extensions and local accounts appear for the browsers and platforms you use. Also note that vulnerability detection correlates the same software inventory with vulnerability data from the Wazuh Cyber Threat Intelligence platform or an offline repository, so an inventory gap also becomes a gap in vulnerability findings. Document who triages new items and how often, because the inventory produces data only your team can act on.

Setting up inventory collection and checking that data arrives

This sequence takes a Wazuh deployment from confirmed central components to a pilot group of endpoints that report software, services, users, groups and browser extension records to the dashboard. Each step ends with a check, so gaps appear on a few machines before the rollout reaches the wider estate.

  1. Confirm the deployment method and central components

    Confirm how the Wazuh indexer, Wazuh server and Wazuh dashboard were deployed, whether all-in-one, step by step, or through another documented method, and record the versions in use. The platform team should confirm that the three components can reach each other and that the dashboard loads for a test administrator account. Check the indexer cluster health and identify the Wazuh server that will hold the agent configuration enrolled endpoints receive. The step is done when every component reports healthy and the team has written down the server address agents will connect to.

  2. Enroll a pilot group on each operating system

    Choose a small pilot set of endpoints on each operating system in scope, covering Linux, Windows and macOS where they apply, and enroll one agent per machine using the method your deployment documents. Assign each agent to a dedicated agent group so the inventory settings can be changed for the pilot without touching the rest of the estate. Pick machines that reflect typical builds, such as a standard desktop image and a server image, so the results are representative. The step is complete when each pilot endpoint has an agent installed and registered with the server.

  3. Check agent status and sample endpoint records

    Open the agent list in the dashboard and confirm each pilot agent shows an active status with the expected hostname, operating system and agent version. Select two or three endpoints and review their basic records to confirm the server is receiving current data from them. If an agent is disconnected, check network reachability to the server, the agent service state and the enrollment credentials before changing anything else. The step is done when every pilot agent reports as active and the sample endpoints show recent check-in times.

  4. Enable inventory modules through agent configuration

    Turn on the inventory collection module in the agent configuration for the pilot group, using the system inventory module described in the Wazuh documentation for software, services, users, groups and browser extensions. Make the change in the group's shared configuration on the Wazuh server, because the server manages agent configuration remotely and pushes it to enrolled agents. Confirm in the current documentation which record types each operating system returns, since coverage can differ between platforms. The step is done when the configuration is saved and the group shows no pending or failed sync.

  5. Confirm the configuration reaches each pilot endpoint

    Check that each pilot agent has received the updated group configuration and has restarted or reloaded as the documentation requires for that change. The server-side view should show each agent as synchronized with its group configuration. If an endpoint has not picked up the change, review its connection to the server and look for local configuration overrides that could stop the new modules from running. The step is done when every pilot agent reports that it is in sync with its assigned group configuration.

  6. Check that inventory records appear for each endpoint

    For each test endpoint, search the dashboard for its software, services, users, groups and browser extension records and compare them with what is installed on that machine. Use known test items, such as an application you installed, a running service, a local user account and a browser extension, and confirm each one appears under the correct endpoint. Note any record type that is missing for a given operating system and check it against the documentation before deciding the module is faulty. The step is done when each record type appears for each test endpoint or has a documented reason for its absence.

  7. Check indexer health and record volumes

    Once inventory records arrive, check the indexer health and the number of inventory records stored for the pilot agents. Confirm the cluster status stays healthy, that storage and shard capacity show no pressure, and that record counts for each endpoint remain stable across repeated check-ins. Ask the vendor or your own environment team which capacity indicators to monitor for your expected endpoint count before the rollout expands. The step is done when indexer health is confirmed, the pilot results are documented and the team has agreed which endpoints move to the next wave.

How the software inventory feeds vulnerability detection

Vulnerability detection in Wazuh is a correlation step. Agents collect the software inventory from each endpoint, and the Wazuh server matches those package records against vulnerability data from either the Wazuh Cyber Threat Intelligence (CTI) platform or an offline vulnerability repository. The inventory is only half of the input, so the detection result depends on which vulnerability source you choose and how current it stays. Before you tune anything, decide which feed is authoritative for your environment. Hosts that can reach the CTI platform have a different option set from air-gapped segments, which need the offline repository described in the Wazuh offline installation guide. Mixed estates often need both. Document which hosts rely on which source so that anyone asking where a finding came from gets a traceable answer.

The age of the vulnerability data matters as much as the age of the inventory. Confirm with Wazuh how often the CTI data is updated. For an offline repository, assign an owner for fetching, transferring and loading each update into the disconnected server, and agree on how often that happens. Write down the staleness you will accept before a feed counts as a control gap. Also check that the inventory collection interval on agents matches your patch cycle. A vulnerability database that updates daily, paired with an inventory that refreshes weekly, will report packages that were already removed or upgraded, and those stale findings will consume triage time without reducing risk.

The inventory records everything installed, including libraries that nothing calls, build tools left on production servers and packages on hosts scheduled for decommissioning. These packages can generate findings that look like exposure but may not be reachable in practice. Decide the triage rule before the first full scan. Define which packages or host groups can be exempted, who approves each exemption, where the reasoning is recorded and whether exemptions expire. Avoid blanket suppression, because it removes the evidence an auditor will ask for. Test the rule on a small host group first (illustratively, a set of servers whose package list you already know), then confirm that the dashboard reflects the change after the next inventory and detection cycle.

Naming differences between the inventory and the vulnerability data create false positives and false negatives. Linux distributions, Windows applications and macOS applications identify the same software in different ways, and distribution maintainers often ship security fixes under an unchanged upstream version number. Correlation can therefore match the wrong product or flag a patched build. After the first full run, review the highest-volume findings for each operating system family and sample a few hosts by hand. Confirm with Wazuh how it handles backported fixes on your distributions. Also confirm the supported operating systems and package managers for vulnerability detection in the current documentation, because coverage differs by platform and that determines the review effort. Keep a log of suppressed matches and recheck them after each feed update.

What to check on each endpoint type before you commit

Linux is usually the first family to pilot, but the distributions in your fleet often differ more than the label suggests. Before you commit, confirm that the agent release you plan to run collects each inventory category you need (packages, services, users, groups and browser extensions) on every distribution and major version in use. Support is tracked per platform and per release, so ask the vendor for the current compatibility information and test on your oldest and newest systems.

Check these points during the pilot:

  • Category availability: Run the inventory on one host per distribution family and confirm each category appears in the indexer and the dashboard.
  • User and group data: Confirm whether accounts come from local files, a directory service or both, and whether service accounts and FreeIPA or LDAP identities appear.
  • Privileges: Identify which collection steps need root and whether any category works under an unprivileged account.
  • Package sources: Verify that the package managers on your build images, including any container host packages, are read correctly.

Close the pilot by comparing inventory counts against a trusted source such as your configuration management tool, and record every gap before you commit.

Security and operational considerations for inventory data

The software and user inventory describes your estate in detail, so the platform that holds it needs the same controls as the systems it describes. The cards below cover who can see inventory data, how administrators sign in, how agents enroll, how central components stay current, and how long data is kept. Each one is a decision to make and check before the dashboard goes live.

Role-based access to dashboard and indexer

The inventory lists installed software, services, local users, groups and browser extensions across endpoints, which would help an attacker plan movement through your estate. Define roles that limit who can search inventory, export results and change configuration, and apply the same model to the Wazuh dashboard and the Wazuh indexer. Test each role with a named account before rollout, and review role membership on a regular schedule.

Single sign-on for administrators

Wazuh supports SAML single sign-on alongside its internal user database, so administrators can authenticate through the identity provider your organization already runs. Documented guides exist for Okta, Microsoft Entra ID, PingOne, Google Workspace, JumpCloud, OneLogin, Keycloak and authentik. Decide which accounts stay on the internal database for break-glass access, and confirm that group-to-role mapping works before you disable local logins for daily use.

Agent enrollment and agent credentials

Every endpoint that reports inventory must enroll with the server, so enrollment has to be controlled. Plan who may register agents, and assign owners for issuing, rotating and revoking the credentials used for enrollment. Confirm in the documentation for your version how agent registration and agent-to-server communication are secured, then test what happens when an agent is decommissioned or its host image is cloned.

Patching the central components

The indexer, server and dashboard hold and expose inventory data, so they need a patching routine of their own. The 4.14 release line shipped patch releases on 17 March, 23 April, 1 July, 29 July, 23 September and 14 October 2026, roughly one every one to two months. Schedule a review after each release, test changes in a non-production environment first, and record which version each component runs.

Retention and access aligned to data rules

Inventory records and alerts accumulate over time, and older records can reveal decommissioned software and former users. Set retention periods with your data protection and records owners, configure the indexer to match, and confirm that deletion works as intended. Review who can query historical data, since access to old inventory may need the same approval as access to current data.

Running inventory and vulnerability detection without internet access

Systems without internet connectivity can still use Wazuh system inventory, but vulnerability detection changes shape. The Wazuh offline installation guide covers installing the platform on networks with no internet access, and vulnerability detection can draw on an offline vulnerability repository in place of the Wazuh Cyber Threat Intelligence platform. Before the build starts, decide who owns the repository, where it is staged, and how it reaches the server. Confirm the exact installation and update steps in the offline guide for the Wazuh release you plan to run, because the procedure is tied to the release and is the authority for your environment.

The repository becomes an operational artifact that someone must move on a schedule. A workable model has a designated operator retrieve the current repository on a connected staging system, pass it through your approved transfer path, and import it into the Wazuh server according to the offline guide. Your media handling rules, malware scanning of transferred files and approval steps all apply to this file just as they do to software packages. Agree on the update cadence in advance. Wazuh 4.14 patch releases have arrived roughly every one to two months, so plan at least that frequency for repository refreshes and check whether your release needs a matching repository version.

Confirming that the data is current is the control that makes offline detection meaningful. Vulnerability detection matches the software inventory that agents collect against vulnerability data, so an outdated repository can leave newly published issues unreported without any visible error. After each import, record the date of the repository and confirm the server reports the new data, then check the vulnerability views in the Wazuh dashboard. As an illustrative test, install a package version known to carry a published vulnerability on a lab endpoint, confirm that the expected finding appears after the import, and keep the result with the update record.

Change records keep the offline process auditable. For every repository update, log the Wazuh release, the repository version and date, the source system, the transfer media identifier, any checksum or signature the process provides, the operator and approver, the import time and the verification result. Store these records alongside your inventory evidence so an assessor can trace which vulnerability data was in force on a given date. Review the log whenever the Wazuh release changes, because the offline guide and repository format may change with it. Ask your partner or internal team to document this procedure as a runbook before go-live.

Limits to confirm in your environment before rollout

Wazuh inventory is useful for IT hygiene only where it matches what your estate actually runs. The points below are the limits to confirm with Wazuh or test in a pilot before you rely on the inventory for decisions, reporting or vulnerability work.

Inventory fields and collection frequency

Ask Wazuh which software, service, user and group fields the system inventory returns for each operating system in your estate, and how often each field refreshes. Collection behavior can differ between Linux, Windows and macOS, and between agent versions, so confirm the field set for every combination you plan to deploy. In the pilot, install the target agent versions on one host per operating system, then compare the returned fields and timing against a known local listing and record the gaps before rollout.

Browser extension coverage by browser and OS

Confirm whether browser extension inventory is available for each browser and operating system in scope, including the browser profiles your users actually run. Coverage can vary by browser and platform, and extensions installed by a managed policy may be reported differently from those a user added alone. Test with a standard profile in each browser by adding and removing an extension, then check whether the change appears after the next collection. Document any browser or platform that remains outside coverage.

History retention and indexer storage

Decide how long inventory history stays in the Wazuh indexer, because each collection adds documents that consume disk. Ask Wazuh how inventory data is indexed, how its retention is configured, and how that setting differs from alert retention. In the pilot, measure index growth over a fixed period across a sample of hosts, then project storage across your estate. Storage is a recurring cost, so include the retention decision in your capacity plan and in any quote you request.

Offline repository coverage across the estate

If any part of the estate has no internet access, confirm that the offline vulnerability repository covers every operating system and package family you run. The Wazuh offline installation guide addresses systems without internet connectivity, but vulnerability correlation is only as complete as the data in the repository. Ask Wazuh for the supported operating system list, then check each distribution, version and third-party software source in your estate against it. Plan how the repository will be updated, because stale data weakens detection.

Not a full asset register or patch tool

Wazuh inventory reports what agents see on enrolled endpoints. It does not replace a full asset register that tracks hardware, ownership, cloud resources, network devices without agents and retired systems, and it does not replace a patch management tool that deploys and verifies fixes. In the pilot, compare the inventory with your asset register and patch tool for the same hosts, then document which systems fall outside agent coverage and who owns closing each gap.

What does it cost and take to run Wazuh inventory for IT hygiene?

Does running Wazuh system inventory cost a license fee?

The self-hosted Wazuh software is open source and carries no license fee, so your costs come from the infrastructure it runs on and the people who build and operate it. Wazuh is distributed under the GNU General Public License version 2, with an exception for linking with OpenSSL. Wazuh Cloud is a separate, vendor-managed service with its own Small, Medium, Large and Custom tiers and a 14-day free trial that needs no credit card. Choosing between self-hosting and Wazuh Cloud changes which costs you carry, so compare both before you budget. Confirm the current terms of each with the vendor.

Which cost drivers change the price of a Wazuh inventory project?

The main drivers are the number and type of endpoints, the central deployment topology, the offline or threat intelligence data path, retention and storage, and how many inventory categories you enable. More endpoints mean more agents to deploy, more inventory data to index and more work to validate. A single-node setup costs less to build than a clustered server and indexer, but a clustered design may be needed for growth. Air-gapped sites need an offline vulnerability repository instead of the Wazuh Cyber Threat Intelligence platform. Longer retention increases indexer storage. Each enabled category, such as browser extensions or services, adds data and tuning work.

What should a written quote for Wazuh inventory include?

A written quote should follow from a written scope and list each deliverable, the environments in scope and the assumptions behind them. Ask for the endpoint count by operating system, the target topology, whether the deployment is online or offline, the retention period you need, and which inventory categories are in scope. Ask who provides infrastructure, certificates, identity integration and access to endpoints, and what happens if those inputs arrive late. Ask which items are one-time work, such as deployment and tuning, and which recur, such as upgrades or support. DeployOpen does not publish a price list, so the quote is the way to compare options.

Can our own team run Wazuh inventory without outside help?

Yes, if your team has the skills to deploy and operate Wazuh, and the software is open source with no license fee. The work involves installing the indexer, server and dashboard, deploying agents to endpoints, configuring inventory collection, connecting vulnerability detection to a data source and keeping the platform upgraded. Teams with Linux, certificate and log pipeline experience usually manage the initial build more easily. Outside help is most useful for a fixed-scope build, a review of an existing deployment or a plan for upgrades. Assess your team's capacity honestly before deciding.

What does the team need to provide for a Wazuh inventory build?

Expect to provide hosts or virtual machines for the central components, network paths from endpoints to the server, a named owner for the endpoint estate and access to change windows. You will also need a decision on how the platform authenticates users, since Wazuh supports SAML single sign-on alongside its internal user database. For air-gapped sites, you will provide an internal way to move the offline vulnerability repository into the network. Confirm storage capacity, backup location and who approves production changes before work starts, because these shape the schedule and the effort.

How long before the first useful Wazuh inventory appears?

The first useful inventory depends on how quickly agents enroll and report, which depends on endpoint count, network reach, deployment method and the number of pilot groups. A small pilot can show software and service data sooner than a full estate rollout. Users, groups and browser extensions need enabled collection and may take longer to review. Vulnerability correlation needs a reachable Cyber Threat Intelligence source or a loaded offline repository. Ask any provider for a milestone plan that separates the pilot, full rollout and tuning phases, and confirm the timeline in writing.

What recurring work comes after the Wazuh inventory is live?

Recurring work includes keeping the central components and agents upgraded, reviewing inventory noise, updating vulnerability sources and maintaining backups. Wazuh shipped several 4.14 patch releases during 2026, so a patch cadence needs an owner. Each upgrade should be tested on a non-production copy before rollout. Retention and storage need periodic review as endpoint counts change. Ask any provider whether upgrades, support and monitoring are one-time or retainer-based, and what the response expectations are in writing. Confirm the support options available for your chosen deployment.

How DeployOpen scopes and delivers Wazuh inventory work

DeployOpen plans and implements Wazuh system inventory inside your own infrastructure, starting from a written scope that defines which endpoints, inventory categories and vulnerability data sources are included. The work covers agent deployment, inventory tuning, dashboards and handover documentation. Engagements are fixed-scope, and ongoing support is available as a retainer.

How we scope

  • The written scope lists the endpoint groups, operating systems and inventory categories to collect.
  • We confirm whether vulnerability correlation uses Wazuh's CTI platform or an offline repository.
  • Scope, deliverables and timelines are agreed in writing before any agent is deployed.

How we build

  • Agents are deployed to in-scope Linux, Windows and macOS endpoints using the agreed installation method.
  • Collection of software, services, users, groups and browser extensions is configured and checked on sample hosts.
  • Inventory data is correlated with vulnerability data, and results are tested against known package versions.

How we hand over

  • Handover includes dashboard views, saved queries and a runbook for reading inventory and vulnerability results.
  • Documentation records the endpoint scope, configuration changes, data sources and any offline repository setup.
  • Your team receives a walkthrough of how inventory changes are triaged and who owns each finding.

How we support

  • Ongoing support is available as a retainer for agent coverage checks, rule tuning and upgrades.
  • Upgrades to Wazuh components and agents follow the order and backup steps in the Wazuh documentation.
  • We confirm with you which testing and change-control steps your own team owns after handover.

Sources and further reading

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.