blob: fb727bb3e27ad4742fa513687497f8490c5a65a7 (
plain)
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
|
# Netdata Windows Installer
Netdata offers a convenient Windows installer for easy setup. This executable provides two distinct installation modes, outlined below.
> **Note**
>
> This feature is currently under beta and only available for Nightly releases, and the installer can be found in our [nightlies repo](https://github.com/netdata/netdata-nightlies). A stable version will be released soon.
## Graphical User Interface (GUI)
Double-clicking the installer initiates the setup process. Since Netdata adds a service to your system, you'll need to provide administrator privileges.
The installer will then guide you through these steps:
1. **Welcome**: This screen provides a summary of the actions the installer will perform.
2. **License Agreements**:
- [Netdata Cloud UI License](https://app.netdata.cloud/LICENSE.txt): Review and accept the license terms to proceed.
- [GPLv3 License](/LICENSE): Read the GNU General Public License v3, which governs the Netdata software.
3. **Destination**: Choose the installation directory. By default, Netdata installs in `C:\Program Files\Netdata`.
4. **Installation**: The installer will copy the necessary files to the chosen directory.
5. **Connect to Netdata Cloud**: To [connect](/src/claim/README.md) your Agent to your Netdata Cloud Space you need to provide the following:
- **Claim Token**: The Claim Token that securely authenticates and links your Agent to your Space.
- **Room IDs**: A comma-separated list of Room IDs where you want to add your Agent.
- **Proxy address**: The address of a proxy server, if one is required for communication with Netdata Cloud.
- **Insecure connection**: By default, Netdata verifies the server's certificate. Enabling this option bypasses verification (use only if necessary).
- **Open Terminal**: Select this option to launch the `MSYS2` terminal after installation completes.
6. **Finish**: The installation process is complete!
## Silent Mode (Command line)
This section provides instructions for installing Netdata in silent mode, which is ideal for automated deployments.
> **Info**
>
> Run the installer as admin to avoid the Windows prompt.
>
> Silent mode skips displaying license agreements, but requires explicitly accepting them using the `/A` option.
### Available Options
| Option | Description |
|-----------|--------------------------------------------------------------------------------------------------|
| `/S` | Enables silent mode installation. |
| `/A` | Accepts all Netdata licenses. This option is mandatory for silent installations. |
| `/D` | Specifies the desired installation directory (defaults to `C:\Program Files\Netdata`). |
| `/T` | Opens the `MSYS2` terminal after installation. |
| `/I` | Forces insecure connections, bypassing hostname verification (use only if absolutely necessary). |
| `/TOKEN=` | Sets the Claim Token for your Netdata Cloud Space. |
| `/ROOMS=` | Comma-separated list of Room IDs where you want your node to appear. |
| `/PROXY=` | Sets the proxy server address if your network requires one. |
### Example Usage
Connect your Agent to your Netdata Cloud Space with token `<YOUR_TOKEN>` and room `<YOUR_ROOM>`:
```bash
netdata-installer-x64.exe /S /A /TOKEN=<YOUR_TOKEN> /ROOMS=<YOUR_ROOM>
```
Replace `<YOUR_TOKEN>` and `<YOUR_ROOM>` with your actual Netdata Cloud Space claim token and room ID, respectively.
> **Note**
>
> The Windows version of Netdata is intended for users on paid plans.
|
