Skip to content

docs: Add post-install dashboard verification to installer README#22980

Draft
nedi-app[bot] wants to merge 2 commits into
masterfrom
docs/netdata-troubleshoot-empty-dashboard-after-installation
Draft

docs: Add post-install dashboard verification to installer README#22980
nedi-app[bot] wants to merge 2 commits into
masterfrom
docs/netdata-troubleshoot-empty-dashboard-after-installation

Conversation

@nedi-app

@nedi-app nedi-app Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Add post-install dashboard verification to installer README. Files changed: packaging/installer/README.md.

User Request

I ran the command to install netdata and it completed, but I don't see anything in the dashboard

Prompt (English)

Troubleshoot empty dashboard after Netdata installation

Reason for Change

This change applies the specific user request using repository-truth evidence from the audit execution workspace.


Summary by cubic

Add a "Verify Your Installation" checklist to packaging/installer/README.md to help users troubleshoot an empty dashboard after installing Netdata. It covers confirming the Agent is running and reachable at http://NODE:19999, choosing the right dashboard (Cloud vs local), checking claim status with netdatacli aclk-state, and opening port 19999 if accessing the local dashboard remotely.

Written for commit ed81ab0. Summary will update on new commits.

Review in cubic

nedi-app Bot added 2 commits July 5, 2026 09:39
…/installer/README.md, placed after the 'Install Directly on Your System' method list and before 'What can I monitor with Netdata?'. The section is a user-altitude checklist covering the four post-install dashboard checks: (1) Agent service running with http://NODE:19999 reachability, (2) where to look for data (Netdata Cloud for claimed nodes vs local Agent dashboard), (3) claim verification with netdatacli aclk-state troubleshooting, and (4) firewall inbound TCP port 19999 for remote local-dashboard access. Detailed procedures are deferred via outbound links to start-stop-restart.md and src/claim/README.md rather than duplicated inline.
@nedi-app nedi-app Bot added the nedi-audit PRs created by the nedi-audit pipeline label Jul 5, 2026
@sonarqubecloud

sonarqubecloud Bot commented Jul 5, 2026

Copy link
Copy Markdown

@github-actions github-actions Bot added area/packaging Packaging and operating systems support area/docs labels Jul 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs area/packaging Packaging and operating systems support nedi-audit PRs created by the nedi-audit pipeline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants