1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
<!--
title: "Get Netdata"
description: "Time to get Netdata's monitoring and troubleshooting solution. Sign in to Cloud, download the Agent everywhere, and connect it all together."
custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/get/README.md
-->
# Get Netdata
import { OneLineInstall } from '../src/components/OneLineInstall/'
import { Install, InstallBox } from '../src/components/InstallBox/'
Netdata uses an open-source monitoring Agent and web application [together](/docs/overview/what-is-netdata.md) to help
you collect every metric, visualize the health of your systems, and troubleshoot complex performance problems. Once
you've signed in to Netdata Cloud and installed the Netdata Agent on all your nodes, you can claim these nodes and see
their real-time metrics on a single interface.
## Sign in to Netdata Cloud
If you don't already have a free Netdata Cloud account, go ahead and [create one](https://app.netdata.cloud).
Choose your preferred authentication method and follow the onboarding process to create your Space.
## Install the Netdata Agent
The Netdata Agent 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.
> ⚠️ Many distributions ship with third-party packages of Netdata, which we cannot maintain or keep up-to-date. For the
> best experience, use one of the methods described or link to below.
The **recommended** way to install the Netdata Agent on a Linux system is our one-line [kickstart
script](/packaging/installer/methods/kickstart.md). This script automatically installs dependencies and builds Netdata
from its source code.
<OneLineInstall />
Copy the script, paste it into your node's terminal, and hit `Enter`.
Open your favorite browser and navigate to `http://localhost:19999` or `http://REMOTE-HOST:19999` to open the dashboard.
<details>
<summary>Watch how the one-line installer works</summary>
<iframe width="820" height="460" src="https://www.youtube.com/embed/tVIp7ycK60A" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</details>
### Other operating systems/methods
Want to install Netdata on a Kubernetes cluster, with Docker, or using a different method? Not a Linux user? Choose your
platform to see specific instructions.
<Install>
<InstallBox
to="/docs/agent/packaging/installer/methods/kubernetes"
img="/img/index/methods/kubernetes.svg"
os="Kubernetes" />
<InstallBox
to="/docs/agent/packaging/docker"
img="/img/index/methods/docker.svg"
os="Docker" />
<InstallBox
to="/docs/agent/packaging/installer/methods/cloud-providers"
img="/img/index/methods/cloud.svg"
os="Cloud providers (GCP, AWS, Azure)" />
<InstallBox
to="/docs/agent/packaging/installer/methods/packages"
img="/img/index/methods/package.svg"
os="Linux with .deb/.rpm" />
<InstallBox
to="/docs/agent/packaging/installer/methods/kickstart-64"
img="/img/index/methods/static.svg"
os="Linux with static 64-bit binary" />
<InstallBox
to="/docs/agent/packaging/installer/methods/manual"
img="/img/index/methods/git.svg"
os="Linux from Git" />
<InstallBox
to="/docs/agent/packaging/installer/methods/freebsd"
img="/img/index/methods/freebsd.svg"
os="FreeBSD" />
<InstallBox
to="/docs/agent/packaging/installer/methods/macos"
img="/img/index/methods/macos.svg"
os="MacOS" />
</Install>
Even more options available in our [packaging documentation](/packaging/installer/README.md#alternative-methods).
## Claim your node on Netdata Cloud
You need to [claim](/claim/README.md) your nodes to see them in Netdata Cloud. Claiming establishes a secure TLS
connection to Netdata Cloud using the [Agent-Cloud link](/aclk/README.md), and proves you have write and administrative
access to that node.
When you view a node in Netdata Cloud, the Agent running on that node streams metrics, metadata, and alarm status to
Netdata Cloud, which in turn streams those metrics to your web browser. Netdata Cloud does not store or log metrics or
alarm status.
To claim a node, you need to run the claiming script. In Netdata Cloud, click on your Space's name, then **Manage your
Space** in the dropdown. Click **Nodes** in the panel that appears. Copy the script and run it in your node's terminal.
For example:
```bash
sudo netdata-claim.sh -token=TOKEN -rooms=ROOM1,ROOM2 -url=https://app.netdata.cloud
```
The script should return `Agent was successfully claimed.` after creating a new RSA pair and establishing the link to
Netdata Cloud.
For more information on the claiming process, why we implemented it, and how it works, see the [claim](/claim/README.md)
and [Agent-Cloud link](/aclk/README.md) reference docs.
<details>
<summary>Watch how claiming nodes works</summary>
<iframe width="820" height="460" src="https://www.youtube.com/embed/UAzVvhMab8g" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</details>
## What's next?
At this point, you have set up your free Netdata Cloud account, installed the Agent, and claimed one or more nodes to
your Space. You're ready to start monitoring, visualizing, and troubleshooting with Netdata. We have two quickstart
guides based on the scope of what you need to monitor:
Interested in monitoring a single node? Check out our [single-node monitoring
quickstart](/docs/quickstart/single-node.md).
If you're looking to monitor an entire infrastructure with Netdata, see the [infrastructure monitoring
quickstart](/docs/quickstart/infrastructure.md).
[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fdocs%2Foverview%2Fnetdata-monitoring-stacka&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)](<>)
|