Skip to main content

Netdata Access Control and Feature Availability

This document explains the access control policies that govern feature availability in Netdata, and how these change based on your authentication and subscription status.

Overview​

Netdata implements a layered access control system to protect sensitive information while keeping core monitoring capabilities freely available. The system distinguishes between three access levels:

Access LevelDescription
AnonymousUsing the Netdata dashboard without signing in
Netdata Cloud CommunitySigned in to Netdata Cloud (free tier)
Netdata Cloud paid planSigned in with a paid plan (Homelab, Business, or Enterprise On-Premise)

Why Access Controls Exist​

Netdata functions can expose sensitive system information:

  • Process details reveal running applications, command-line arguments (which may contain passwords or tokens), and resource consumption patterns
  • Network connections expose active services, connected clients, and internal network topology
  • System logs may contain application errors, security events, and debugging information with sensitive context
  • Database queries can reveal query patterns, table structures, and potentially sensitive data in error messages

Without authentication, anyone who can reach the Netdata dashboard could access this information. The access control system ensures that sensitive data is only available to authenticated users who belong to the same Netdata Cloud Space as the monitored infrastructure.

Feature Availability by Access Level​

Metrics and Visualization​

FeatureAnonymousCommunityPaid
Real-time metrics (all collectors)✓✓✓
Historical data and retention✓✓✓
Charts and dashboards✓✓✓
Anomaly detection (ML)✓✓✓
Alert notifications✓✓✓
Node dashboard access5 nodes5 nodesUnlimited
Custom dashboards1 per agent1 per roomUnlimited

Functions (Live Tab)​

Functions provide on-demand, detailed information beyond standard metrics.

FunctionDescriptionAnonymousCommunityPaid
Block DevicesDisk I/O activity✓✓✓
Containers/VMsContainer and VM resource usage✓✓✓
IPMI SensorsHardware sensor readings✓✓✓
Mount PointsDisk usage per mount✓✓✓
Network InterfacesInterface traffic and status✓✓✓
Systemd ServicesService resource usage✓✓✓
ProcessesRunning processes, command lines, resources✗✓✓
Network ConnectionsActive TCP/UDP connections✗✓✓
Systemd JournalSystem and application logs✗✓✓
Windows EventsWindows event logs✗✓✓
Systemd UnitsUnit status and configuration✗✓✓
Database QueriesTop queries, deadlocks, errors✗✓✓
Streaming StatusNetdata streaming topology✗✓✓
API Call TracingNetdata API request tracing✗✓✓

Configuration and Management​

FeatureAnonymousCommunityPaid
View agent configuration✗✗✓
Dynamic Configuration (collectors)✗✗✓
Dynamic Configuration (alerts)✗✗✓
Alert silencing rules✗✓✓
Notification configuration✗✗✓

AI-Powered Features​

FeatureAnonymousCommunityPaid
Alert explanations✗✗✓
Alert configuration suggestions✗✗✓
AI-powered insights✗✗✓

Organization Features​

FeatureAnonymousCommunityPaid
Role-based access control (RBAC)N/A✗✓
Single Sign-On (SSO)N/A✗✓
Team managementN/ALimitedFull

MCP (Model Context Protocol)​

Netdata provides MCP in two ways:

  • Netdata Cloud MCP at app.netdata.cloud/api/v1/mcp — infrastructure-wide access to all your nodes (requires a Paid plan)
  • Agent/Parent MCP — available directly at Netdata Agents and Parents, free and open-source

When accessing Netdata via Agent/Parent MCP:

  • Without Cloud connection: MCP can access public functions and metrics, but sensitive functions follow the same restrictions as the dashboard
  • With Cloud connection: MCP inherits the user's Cloud permissions, enabling access to sensitive functions for authenticated users
  • With [web].bearer token protection = yes: local MCP requires the local MCP API key on all transports (HTTP, SSE, WebSocket); anonymous MCP requests are rejected
  • Network ACL: local MCP exposure is controlled by [web].allow mcp from (in addition to the global [web].allow connections from)

For MCP setup and configuration, see the MCP documentation.

How to Enable Features​

Enable Sensitive Functions​

  1. Sign in to Netdata Cloud at app.netdata.cloud
  2. Connect your nodes to your Netdata Cloud Space
  3. Access the dashboard through Netdata Cloud

Once signed in, you'll have access to all sensitive functions (processes, logs, network connections, etc.) on nodes within your Space.

Enable Dynamic Configuration​

Dynamic Configuration requires a paid plan:

  1. Sign in to Netdata Cloud
  2. Upgrade to a paid plan from the billing settings
  3. Access Dynamic Configuration from the settings menu on any connected node

Increase Node Limits​

The 5-node limit applies to both Anonymous and Community users, on Netdata Cloud dashboards and on the local dashboard of Agents and Parents. You can:

  1. Upgrade to a paid plan for unlimited nodes
  2. Select preferred nodes to choose which 5 nodes stay accessible

This limit is a plan entitlement, not a streaming or connection limit. You can stream any number of nodes to a parent and chain parents across multiple levels — both are fully supported, and every node continues collecting and storing its data regardless of this limit. On a dashboard that shows more nodes than your limit, a node outside your preferred nodes shows as Locked: every per-node feature — its single-node dashboard, Functions, Configuration, silencing rules, Anomaly Advisor, and alert details — becomes inaccessible, and it is excluded from the combined Metrics tab, until you either select it as one of your preferred nodes or upgrade to a paid plan.

The local dashboard of an Agent or Parent gets the limit of your plan from Netdata Cloud. When the Agent is not connected to Netdata Cloud, or Netdata Cloud cannot be reached, the local dashboard applies the 5-node limit.

note

Netdata Cloud and each Agent keep separate preferred-node lists. Netdata Cloud stores one per Space (Space Settings > Nodes). An Agent or Parent stores its own in its settings, and you select it on that Agent's local dashboard (http://<agent-ip>:19999). Which nodes appear in the local dashboard's multi-node views is still determined by the Agent's streaming configuration.

Summary​

What You GetAnonymousCommunityPaid
Metrics & ChartsFull accessFull accessFull access
Anomaly DetectionFull accessFull accessFull access
Alert NotificationsFull accessFull accessFull access
Public FunctionsFull accessFull accessFull access
Sensitive FunctionsBlockedFull accessFull access
AI FeaturesBlockedNot availableFull access
Dynamic ConfigurationBlockedBlockedFull access
Node Dashboard Access5 nodes5 nodesUnlimited
Custom Dashboards1 per agent1 per roomUnlimited
RBAC & SSON/ANot availableFull access

Netdata's access control model ensures that sensitive system information is protected while keeping powerful monitoring capabilities freely available. Sign in to Netdata Cloud to unlock sensitive functions, or upgrade to a paid plan for full configuration control and unlimited scale.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.