Netdata Agent Installation

Netdata is very flexible and can be used to monitor all kinds of infrastructure. Read more about possible Deployment guides to understand what better suites your needs.

Install through Netdata Cloud

The easiest way to install Netdata on your system is via Netdata Cloud, to do so:

1. Sign in to https://app.netdata.cloud/.
2. Select a Space, and click the "Connect Nodes" prompt, which will show the install command for your platform of choice.
3. Copy and paste the script into your node's terminal, and run it.

Once Netdata is installed, you can see the node live in your Netdata Space and charts in the Metrics tab.

Install Directly on Your System

You can also install Netdata directly without connecting to Netdata Cloud. Choose your platform below:

Operating Systems

Linux - Install on any Linux distribution → Install on Linux

Windows - Native Windows monitoring agent → Install on Windows

macOS - Monitor your Mac systems → Install on macOS

FreeBSD - Install on FreeBSD systems → Install on FreeBSD

Containerized Environments

Docker - Run Netdata in Docker containers → Install with Docker

Kubernetes - Deploy across Kubernetes clusters → Install on Kubernetes

Network Appliances

pfSense - Monitor pfSense firewalls → Install on pfSense

Synology - Install on Synology NAS devices → Install on Synology

Automation & Cloud Platforms

Ansible - Automate deployment with Ansible → Install with Ansible

AWS - Deploy on Amazon Web Services → Install on AWS

Azure - Deploy on Microsoft Azure → Install on Azure

GCP - Deploy on Google Cloud Platform → Install on GCP

Verify Your Installation

If the installation completed but nothing appears in your dashboard, work through this checklist:

1. Confirm the Agent service is running. Check the service status for your platform and confirm the Agent is reachable at http://NODE:19999.

2. Open the right dashboard for your setup. For connected nodes, check Netdata Cloud. For a node that is not connected to Netdata Cloud, or for local-only access, open the local Agent dashboard at http://NODE:19999.

3. If the node is missing from Netdata Cloud, verify it was connected. Connecting links the Agent to your Netdata Cloud Space. See Connect Agent to Cloud for the steps. If the Agent was already connected but the node still does not appear, see Troubleshooting to check the Cloud connection status.

4. Allow inbound TCP port 19999 for local dashboard access from another machine. The host firewall on the node must permit connections to the Agent's port. If the local dashboard does not load from a remote browser, confirm port 19999 is open on the node.

What can I monitor with Netdata?

Netdata can monitor virtually any system, application, or service. Discover what you can monitor and explore our extensive integrations catalog.

→ Explore what Netdata can monitor