Compatibility Matrix - Wazuh Dashboard Plugins

Overview

Wazuh Dashboard Plugins require specific versions of dependencies to function correctly. This page provides comprehensive compatibility information for different versions.

Always verify compatibility before installation to avoid runtime issues and ensure proper functionality.

Current Version (5.0.0)

Wazuh Dashboard Plugins 5.0.0-alpha0

Plugin Version

5.0.0-00

Platform Version

3.5.0

Stage

alpha0

Core Dependencies

Component	Version	Required
OpenSearch Dashboards	3.5.0	Yes
Node.js	22.22.0	Yes
Wazuh Server	5.0.0	Yes
Yarn	1.22.0+	Yes
TypeScript	5.5.2	Yes (dev)

Plugin Dependencies

Main Plugin (wazuh)

Required OpenSearch Dashboards Plugins

[
  "navigation",
  "data",
  "dashboard",
  "embeddable",
  "discover",
  "inspector",
  "visualizations",
  "uiActions",
  "charts",
  "savedObjects",
  "opensearchDashboardsReact",
  "opensearchDashboardsUtils",
  "opensearchDashboardsLegacy",
  "wazuhCheckUpdates",
  "wazuhCore"
]

Optional OpenSearch Dashboards Plugins

[
  "security",
  "securityDashboards",
  "searchguard",
  "telemetry",
  "notificationsDashboards",
  "alertingDashboards",
  "reportsDashboards"
]

Wazuh Core Plugin (wazuhCore)

Dependency	Version	Purpose
Required Plugins	`navigation`, `opensearchDashboardsUtils`	Core functionality
Optional Plugins	`securityDashboards`	Enhanced security features

Wazuh Check Updates Plugin (wazuhCheckUpdates)

Dependency	Version	Purpose
Required Plugins	`navigation`, `opensearchDashboardsUtils`, `opensearchDashboardsReact`, `wazuhCore`	Update checking
Optional Plugins	`securityDashboards`	Security integration

JavaScript/Node.js Dependencies

Main Plugin
Wazuh Core
Wazuh Check Updates

Production Dependencies

{
  "axios": "1.13.3",
  "dompurify": "3.2.4",
  "js2xmlparser": "^5.0.0",
  "jsdom": "^16.6.0",
  "json-2-csv": "^3.20.0",
  "jwt-decode": "^3.1.2",
  "loglevel": "1.9.2",
  "markdown-it-link-attributes": "^4.0.1",
  "md5": "^2.3.0",
  "node-cron": "^1.1.2",
  "react-cookie": "^4.0.3"
}

Development Dependencies

{
  "@typescript-eslint/eslint-plugin": "^6.2.1",
  "@typescript-eslint/parser": "^6.2.1",
  "eslint": "^8.46.0",
  "prettier": "^2.7.1",
  "typescript": "^5.5.2"
}

Production Dependencies

{
  "axios": "1.13.3",
  "jwt-decode": "^3.1.2",
  "md5": "^2.3.0",
  "node-cron": "^3.0.2"
}

Production Dependencies

{
  "axios": "1.13.3",
  "md5": "^2.3.0",
  "node-cron": "^3.0.2"
}

Security Resolutions

The plugins enforce specific versions for security-critical dependencies:

{
  "**/es5-ext": "^0.10.63",
  "**/follow-redirects": "^1.15.6",
  "cross-spawn": "^7.0.5",
  "**/@babel/runtime-corejs3": "^7.27.0",
  "smol-toml": "1.3.1",
  "micromatch": "4.0.8",
  "form-data": "^4.0.4",
  "tar-fs": "2.1.4",
  "cookie": "0.7.0"
}

Historical Compatibility

Wazuh 4.x Series

4.14.x
4.13.x
4.12.x

Wazuh 4.14.5

Component	Version
OpenSearch Dashboards	2.19.4
Wazuh Server	4.14.5
Plugin Revision	00

Component	Version
OpenSearch Dashboards	2.18.x
Wazuh Server	4.13.x

Component	Version
OpenSearch Dashboards	2.17.x
Wazuh Server	4.12.x

Docker Environment Compatibility

Development Images

Wazuh provides pre-built Docker images for development:

Image	Platform Version	Node.js	Registry
osd-dev:3.5.0	OpenSearch Dashboards 3.5.0	22.22.0	quay.io/wazuh
osd-dev:2.19.0	OpenSearch Dashboards 2.19.0	18.x	quay.io/wazuh
osd-dev:2.18.0	OpenSearch Dashboards 2.18.0	18.x	quay.io/wazuh

Docker Requirements

Docker Desktop

Version with Docker Compose 2.20.2+

System Resources

8 GB RAM minimum, 4 CPU cores

Browser Compatibility

The Wazuh Dashboard Plugins support modern browsers:

Supported
Not Supported

Chrome 90+
Firefox 88+
Safari 14+
Edge 90+

Operating System Compatibility

Development

OS	Version	Support Status
Ubuntu	20.04, 22.04, 24.04	Full
Debian	10, 11, 12	Full
Fedora	38, 39, 40	Full
macOS	12+, 13+, 14+	Full
Windows	10, 11 (via WSL2)	Full

Production

For production deployments, refer to the Wazuh Installation Guide for complete OS compatibility.

API Compatibility

Wazuh Server API

The dashboard plugins communicate with the Wazuh Server API:

Plugin Version	Compatible API Versions
5.0.0	5.0.0
4.14.x	4.14.x
4.13.x	4.13.x

API Version Mismatch: Ensure your Wazuh Dashboard Plugin version matches your Wazuh Server version for optimal compatibility.

API Endpoints

The plugins use these API specifications:

# Version 5.0.0 API spec
https://raw.githubusercontent.com/wazuh/wazuh/v5.0.0/api/api/spec/spec.yaml

# Version 4.14.x API spec
https://raw.githubusercontent.com/wazuh/wazuh/v4.14.0/api/api/spec/spec.yaml

Index Pattern Compatibility

Version 5.0.0 Index Patterns

Wazuh 5.0.0 introduced new index patterns:

wazuh-events*

wazuh-events-security*
wazuh-events-system-activity*
wazuh-events-network-activity*
wazuh-events-access-management*
wazuh-events-applications*

wazuh-events-cloud-services*
wazuh-events-cloud-services-aws*
wazuh-events-cloud-services-azure*
wazuh-events-cloud-services-gcp*

wazuh-states-it-hygiene*
wazuh-states-it-hygiene-packages*
wazuh-states-fim-files*
wazuh-states-vulnerabilities*
wazuh-states-sca*

Migration Note: Wazuh 5.0.0 replaced wazuh-alerts* with wazuh-events* as the default index pattern.

Elasticsearch vs OpenSearch

Platform Evolution

Version Range	Platform	Notes
4.3+	OpenSearch Dashboards	Primary platform
4.2-4.3	OpenSearch & Elastic	Dual support
< 4.2	Kibana (Elastic)	Legacy

Current Focus

Wazuh Dashboard Plugins 5.0.0 exclusively supports OpenSearch Dashboards.

Security Plugin Compatibility

Wazuh integrates with various security plugins:

Security Plugin	Version	Status
OpenSearch Security	3.5.0	Supported
Security Dashboards	3.5.0	Supported
Search Guard	Compatible versions	Optional

Upgrade Paths

From 4.14.x to 5.0.0

Review Breaking Changes

Index patterns changed from wazuh-alerts* to wazuh-events*
Removed deprecated modules (OpenSCAP, CIS-CAT, Osquery)
Configuration migrated from wazuh.yml to opensearch_dashboards.yml

Backup Data

Backup your OpenSearch indices and configuration

Upgrade Components

Upgrade Wazuh Server to 5.0.0
Upgrade OpenSearch to compatible version
Upgrade OpenSearch Dashboards to 3.5.0
Install Wazuh Dashboard Plugins 5.0.0

Verify Health Checks

Allow automatic health checks to recreate index patterns and configurations

Major Version Upgrade: Upgrading from 4.x to 5.0 includes breaking changes. Review the CHANGELOG carefully.

Testing Compatibility

Before deploying to production, verify compatibility:

Development Environment

Test with Docker development environment

Run Health Checks

Verify all health checks pass after installation

API Connectivity

Confirm dashboard can communicate with Wazuh Server API

Index Patterns

Ensure index patterns are created correctly

Getting Help

If you encounter compatibility issues:

GitHub Issues

Report bugs and compatibility problems

Slack Community

Get help from the community

Documentation

Read official documentation

Forums

Join community discussions

Version Checking

To verify your installed versions:

# Check Node.js version
node --version

# Check plugin versions
bin/opensearch-dashboards-plugin list

# Check OpenSearch Dashboards version
cat config/opensearch_dashboards.yml | grep version

# Inside the repository, check Wazuh plugin version
cat VERSION.json

Future Compatibility

Wazuh maintains backward compatibility within major versions (e.g., 5.x series). However, major version upgrades may include breaking changes.

Stay updated with:

​Overview

​Current Version (5.0.0)

​Wazuh Dashboard Plugins 5.0.0-alpha0

Plugin Version

Platform Version

Stage

​Core Dependencies

​Plugin Dependencies

​Main Plugin (wazuh)

​Wazuh Core Plugin (wazuhCore)

​Wazuh Check Updates Plugin (wazuhCheckUpdates)

​JavaScript/Node.js Dependencies

​Production Dependencies

​Development Dependencies

​Production Dependencies

​Production Dependencies

​Security Resolutions

​Historical Compatibility

​Wazuh 4.x Series

​Wazuh 4.14.5

​Wazuh 4.13.x

​Wazuh 4.12.x

​Docker Environment Compatibility

​Development Images

​Docker Requirements

Docker Desktop

System Resources

​Browser Compatibility

​Operating System Compatibility

​Development

​Production

​API Compatibility

​Wazuh Server API

​API Endpoints

​Index Pattern Compatibility

​Version 5.0.0 Index Patterns

​Elasticsearch vs OpenSearch

​Platform Evolution

​Current Focus

​Security Plugin Compatibility

​Upgrade Paths

​From 4.14.x to 5.0.0

​Testing Compatibility

​Getting Help

GitHub Issues

Slack Community

Documentation

Forums

​Version Checking

​Future Compatibility

Overview

Current Version (5.0.0)

Wazuh Dashboard Plugins 5.0.0-alpha0

Core Dependencies

Plugin Dependencies

Main Plugin (wazuh)

Wazuh Core Plugin (wazuhCore)

Wazuh Check Updates Plugin (wazuhCheckUpdates)

JavaScript/Node.js Dependencies

Production Dependencies

Development Dependencies

Production Dependencies

Production Dependencies

Security Resolutions

Historical Compatibility

Wazuh 4.x Series

Wazuh 4.14.5

Wazuh 4.13.x

Wazuh 4.12.x

Docker Environment Compatibility

Development Images

Docker Requirements

Browser Compatibility

Operating System Compatibility

Development

Production

API Compatibility

Wazuh Server API

API Endpoints

Index Pattern Compatibility

Version 5.0.0 Index Patterns

Elasticsearch vs OpenSearch

Platform Evolution

Current Focus

Security Plugin Compatibility

Upgrade Paths

From 4.14.x to 5.0.0

Testing Compatibility

Getting Help

Version Checking

Future Compatibility