|
@@ -2,29 +2,21 @@
|
|
|
|
|
|
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.
|
|
|
+## Download the MSI Installer
|
|
|
|
|
|
-## Graphical User Interface (GUI)
|
|
|
+You can download the Netdata Windows installer (MSI) from the official releases page:
|
|
|
|
|
|
-Double-clicking the installer initiates the setup process. Since Netdata adds a service to your system, you'll need to provide administrator privileges.
|
|
|
+| Version | Description |
|
|
|
+|--------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
|
+| [Stable](https://github.com/netdata/netdata/releases/latest/download/netdata-x64.msi) | This is the recommended version for most users as it provides the most reliable and well-tested features. |
|
|
|
+| [Nightly](https://github.com/netdata/netdata-nightlies/releases/latest/download/netdata-x64.msi) | Offers the latest features but may contain bugs or instabilities. Use this option if you require access to the newest features and are comfortable with potential issues. |
|
|
|
+
|
|
|
+## Graphical User Interface (GUI)
|
|
|
|
|
|
-The installer will then guide you through these steps:
|
|
|
+1. **Double-click** the installer to begin the setup process.
|
|
|
+2. **Grant Administrator Privileges**: You'll need to provide administrator permissions to install the Netdata service.
|
|
|
|
|
|
-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!
|
|
|
+Once installed, you can access your Netdata dashboard at `localhost:19999`.
|
|
|
|
|
|
## Silent Mode (Command line)
|
|
|
|
|
@@ -34,30 +26,28 @@ This section provides instructions for installing Netdata in silent mode, which
|
|
|
>
|
|
|
> 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.
|
|
|
+> Using silent mode implicitly accepts the terms of the [GPL-3](https://raw.githubusercontent.com/netdata/netdata/refs/heads/master/LICENSE) (Netdata Agent) and [NCUL1](https://app.netdata.cloud/LICENSE.txt) (Netdata Web Interface) licenses, skipping the display of agreements.
|
|
|
|
|
|
### 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. |
|
|
|
+| Option | Description |
|
|
|
+|--------------|--------------------------------------------------------------------------------------------------|
|
|
|
+| `/qn` | Enables silent mode installation. |
|
|
|
+| `/i` | Specifies the path to the MSI installer file. |
|
|
|
+| `INSECURE=1` | 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>
|
|
|
+msiexec /qn /i netdata-x64.msi TOKEN="<YOUR_TOKEN>" ROOMS="<YOUR_ROOM>"
|
|
|
```
|
|
|
|
|
|
-Replace `<YOUR_TOKEN>` and `<YOUR_ROOM>` with your actual Netdata Cloud Space claim token and room ID, respectively.
|
|
|
+Replace `<YOUR_TOKEN>` and `<YOUR_ROOM>` with your Netdata Cloud Space claim token and room ID, respectively.
|
|
|
|
|
|
> **Note**
|
|
|
>
|