Get started with Netdata
Netdata is a free and open-source (FOSS) monitoring agent that collects thousands of hardware and software metrics from any physical or virtual system (we call them nodes). These metrics are organized in an easy-to-use and -navigate interface.
Together with Netdata Cloud, you can monitor your entire infrastructure in real time and troubleshoot problems that threaten the health of your nodes.
Netdata runs permanently on all your physical/virtual servers, containers, cloud deployments, and edge/IoT devices. It
runs on Linux distributions (Ubuntu, Debian, CentOS, and more), container/microservice platforms (Kubernetes clusters,
Docker), and many other operating systems (FreeBSD, macOS), with no sudo
required.
Install on Linux with one-line installer
The recommended way to install Netdata on a Linux node (physical, virtual, container, IoT) is our one-line kickstart script. This script automatically installs dependencies and builds Netdata from its source code.
Copy the script, paste it into your node's terminal, and hit Enter
to begin the installation process.
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh
Jump down to what's next to learn how to view your new dashboard and take your next steps monitoring and troubleshooting with Netdata.
Other installation options
Run with Docker
Deploy on Kubernetes
Install on macOS
Linux from Git
Linux from source
Linux for offline nodes
What's next?
To start using Netdata, open a browser and navigate to http://NODE:19999
, replacing NODE
with either localhost
or
the hostname/IP address of a remote node.
Where you go from here is based on your use case, immediate needs, and experience with monitoring and troubleshooting.
Dashboard
Learn more about how the dashboard works, or dive directly into the many ways to interact with charts.
Configuration
Discover the recommended way to configure Netdata's settings or behavior using our built-in
edit-config
script, then apply that knowledge to mission-critical tweaks, such as changing how long Netdata stores
metrics.
Data collection
If Netdata didn't autodetect all the hardware, containers, services, or applications running on your node, you should learn more about how data collectors work. If there's a supported collector for metrics you need, configure the collector or read about its requirements to configure your endpoint to publish metrics in the correct format and endpoint.
Alarms & notifications
Netdata comes with hundreds of preconfigured alarms, designed by our monitoring gurus in parallel with our open-source community, but you may want to edit alarms or enable notifications to customize your Netdata experience.
Need to monitor multiple nodes in one place?
For robust multi-node monitoring from a single interface, consider Netdata Cloud, which streams, aggregates, and visualizes metrics from any number of nodes. It's all the same out-of-the-box, zero-configuration functionality of the open-source monitoring agent, but for any number of distributed nodes, entirely for free.
There is an alternative for those who aren't interested in using Netdata Cloud, albeit with some required configuration. Each node can stream its metrics to any other node, and the default registry is configurable to create a private "network" of Netdata dashboards.
Was this page helpful?
Need further help?
Search for an answer in our community forum.
Contribute
- Join our community forum
- Learn how to contribute to Netdata's open-source project
- Submit a feature request