imported>TechCorner-Redaktion: Import aus Wazuh-Blog (m.a.x. it, eigenes Copyright)

2026-09-15T00:00:00Z

Import aus Wazuh-Blog (m.a.x. it, eigenes Copyright)

Neue Seite

== Ursachenanalyse und saubere Lösung bei Distributed / All-in-One Deployments ==

=== Einleitung ===

Beim Deployment des '''Wazuh Dashboards''' nach offizieller Anleitung kann es zu einer verwirrenden Situation kommen:

* Der Dienst <code>wazuh-dashboard</code> läuft scheinbar korrekt
* Die Weboberfläche ist '''nicht erreichbar'''
* Die Datei <code>/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml</code> existiert '''nicht'''

Dieser Artikel erklärt:

* warum diese Datei fehlt
* warum das Dashboard nicht startet
* wie ein '''Port- und Berechtigungsproblem (EACCES)''' die eigentliche Ursache ist
* und wie man das Problem sauber behebt

== 1. Ausgangssituation ==

=== Setup ===

* Deployment-Typ: '''Distributed''', Manager + Dashboard auf demselben Server
* Wazuh Version: 4.14.x
* Installation gemäß offizieller Anleitung:[https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html?utm_source=chatgpt.com https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html]

=== Beobachtungen ===

* <code>wazuh-dashboard</code> Service läuft
* Datei <code>wazuh.yml</code> fehlt
* Web UI unter <code>https://<host></code> '''nicht erreichbar'''
* Verzeichnis <code>/usr/share/wazuh-dashboard/data/wazuh/config/</code> ist leer

== 2. Wichtige Hintergrundinfo: Wann wird wazuh.yml erstellt? ==

Die Datei <code>wazuh.yml</code> wird '''nicht''' während der Paketinstallation erzeugt.

📌 '''Sie wird erst automatisch generiert''', wenn:

* das Dashboard '''erfolgreich startet'''
* und die Wazuh-App im UI '''zum ersten Mal geladen wird'''

➡️ '''Wenn das Dashboard gar nicht erreichbar ist, kann die Datei nicht entstehen.'''

== 3. Der entscheidende Hinweis: Blick in die Logs ==

Der Durchbruch kam mit:

<syntaxhighlight lang="text">
journalctl -u wazuh-dashboard | grep -i -E "error|warn"
</syntaxhighlight>

=== Fehlerausgabe ===

<syntaxhighlight lang="text">
FATAL Error: listen EACCES: permission denied wazuh-manager:443
code: 'EACCES'
port: 443
</syntaxhighlight>

== 4. Root Cause: Port 443 & Linux-Berechtigungen ==

=== Warum passiert das? ===

Unter Linux gilt:

* '''Ports

== 5. Verifikation: Ist Port 443 bereits belegt? ==

<syntaxhighlight lang="text">
sudo lsof -i :443
</syntaxhighlight>

=== Erwartete Ausgabe (wenn korrekt konfiguriert): ===

<syntaxhighlight lang="text">
node 696 wazuh-dashboard TCP *:https (LISTEN)
</syntaxhighlight>

Wenn:

* kein Prozess lauscht → Permission-Problem
* anderer Dienst lauscht (nginx, apache, proxy) → Port-Konflikt

== 6. Saubere Lösungen (Best Practice) ==

=== Option A – Dashboard auf anderen Port legen (empfohlen) ===

In:

<syntaxhighlight lang="text">
/etc/wazuh-dashboard/opensearch_dashboards.yml
</syntaxhighlight>

<syntaxhighlight lang="text">
server.port: 5601
</syntaxhighlight>

Danach:

<syntaxhighlight lang="text">
systemctl restart wazuh-dashboard
</syntaxhighlight>

Zugriff:

<syntaxhighlight lang="text">
https://<host>:5601
</syntaxhighlight>

📘 Referenz:
[https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html#configuring-the-wazuh-dashboard https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html#configuring-the-wazuh-dashboard]

=== Option B – Reverse Proxy verwenden (Enterprise-Standard) ===

* Dashboard bleibt auf '''5601'''
* NGINX / HAProxy bindet Port '''443'''
* TLS, Auth & Routing sauber getrennt

📚 Beispiele:

* [https://documentation.wazuh.com/current/user-manual/wazuh-server-cluster/load-balancers.html?utm_source=chatgpt.com https://documentation.wazuh.com/current/user-manual/wazuh-server-cluster/load-balancers.html]
* [https://nginx.org/en/docs/http/ngx_http_proxy_module.html https://nginx.org/en/docs/http/ngx_http_proxy_module.html]

=== Option C – CAP_NET_BIND_SERVICE setzen (nicht empfohlen) ===

<syntaxhighlight lang="text">
setcap 'cap_net_bind_service=+ep' /usr/share/wazuh-dashboard/node/bin/node
</syntaxhighlight>

⚠️ '''Nicht empfohlen''':

* Sicherheitsrisiko
* Update-anfällig
* widerspricht Hardening-Guidelines

== 7. Ergebnis nach Fix ==

Nach erfolgreichem Start des Dashboards:

* Web UI ist erreichbar
* Wazuh-App lädt korrekt
* Datei wird automatisch erzeugt:

<syntaxhighlight lang="text">
/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml
</syntaxhighlight>

Ab jetzt:

* manuelle Anpassungen möglich
* API- & Cluster-Verbindungen konfigurierbar

== 8. Typische Missverständnisse (Lessons Learned) ==

AnnahmeRealitätwazuh.yml fehlt → Installation kaputt❌Datei muss manuell angelegt werden❌Dashboard läuft → UI erreichbar❌Fehler liegt bei Indexer❌Port-Berechtigungen sind egal❌

➡️ '''Das eigentliche Problem war ein klassischer Linux-Port-Permission-Fehler.'''

== 9. Relevante Quellen & weiterführende Links ==

=== Offizielle Wazuh Dokumentation ===

* Wazuh Dashboard Installation[https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html?utm_source=chatgpt.com https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html]
* Dashboard Konfiguration[https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html#configuring-the-wazuh-dashboard https://documentation.wazuh.com/current/installation-guide/wazuh-dashboard/step-by-step.html#configuring-the-wazuh-dashboard]

=== Linux & Security ===

* Linux Privileged Ports[https://man7.org/linux/man-pages/man7/ip.7.html https://man7.org/linux/man-pages/man7/ip.7.html]
* Linux Capabilities[https://man7.org/linux/man-pages/man7/capabilities.7.html https://man7.org/linux/man-pages/man7/capabilities.7.html]

=== Reverse Proxy Best Practices ===

* NGINX Reverse Proxy[https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/ https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/]
* HAProxy TLS Terminationhttps://www.haproxy.com/documentation/hapee/latest/security/tls/

== Fazit ==

❝ Wenn ''wazuh.yml'' fehlt, ist das '''kein Konfigurationsfehler''',
sondern ein '''Symptom eines nicht erreichbaren Dashboards'''. ❞

Die Lösung liegt fast immer bei:

* '''Ports'''
* '''Rechten'''
* '''Service-Startbedingungen'''

Mit sauberer Port-Trennung oder Reverse Proxy läuft das Dashboard stabil – und die Konfigurationsdateien entstehen automatisch.

[https://wazuh.slack.com/archives/C07CNG3M11N/p1766137365065569 https://wazuh.slack.com/archives/C07CNG3M11N/p1766137365065569]

== Quelle ==
Dieser Artikel stammt aus dem [https://wazuh-blog.max-it.de/fehlende-wazuh-yml-nicht-erreichbares-wazuh-dashboard/ Wazuh-Blog von m.a.x. it] (veröffentlicht am 16. März 2026).

== Unterstützung von m.a.x. it ==
Bei Einführung, Betrieb und Feintuning von Wazuh (SIEM) unterstützt Sie m.a.x. it mit [https://www.max-it.de/it-services/siem-open-source/ SIEM-Services auf Open-Source-Basis].

{{Uebermax}}
[[Kategorie:Wazuh]]

Fehlende wazuh.yml & nicht erreichbares Wazuh Dashboard - Versionsgeschichte

imported>TechCorner-Redaktion: Import aus Wazuh-Blog (m.a.x. it, eigenes Copyright)