Windows updated (#20358)
Co-authored-by: ilyam8 <ilya@netdata.cloud>
Kanela committed
May 28, 2025 at 10:35 UTC
9392f1ec969906d63f110522851a57ed6144d6e2
1 file changed
+83
-19
packaging/windows/WINDOWS_INSTALLER.md
+83
-19
@@ -9,8 +9,6 @@ Free users will have limited functionality.
9
10
:::
11
12
----
13
-
12
## Limitations for Free Users
13
14
| Agent Type | Limitation |
@@ -18,8 +16,6 @@ Free users will have limited functionality.
16
| Standalone Agent | UI is locked — No local monitoring |
17
| Child Agent | No monitoring data in parent dashboard when streaming to a Linux-based Netdata parent |
18
21
----
22
-
19
## Download the Windows Installer (MSI)
20
21
Choose the version that suits your needs:
@@ -29,8 +25,6 @@ Choose the version that suits your needs:
25
| Stable | [Download Stable](https://github.com/netdata/netdata/releases/latest/download/netdata-x64.msi) | Most users — stable, well-tested |
26
| Nightly | [Download Nightly](https://github.com/netdata/netdata-nightlies/releases/latest/download/netdata-x64.msi) | Users who need the latest features and can handle potential bugs |
27
32
----
33
-
28
## Silent Installation (Command Line)
29
30
Use silent mode to deploy Netdata without user interaction (ideal for automation).
@@ -41,8 +35,6 @@ Run the command prompt as Administrator.
35
36
:::
37
44
----
45
-
38
### Installation Command Options
39
40
| Option | Description |
@@ -54,8 +46,6 @@ Run the command prompt as Administrator.
46
| `PROXY=` | (Optional) Proxy address if required |
47
| `INSECURE=1` | (Optional) Allow insecure connections (hostname verification disabled) |
48
57
----
58
-
49
### Example Command
50
51
Install Netdata and connect to your Cloud Space:
@@ -69,16 +59,12 @@ Replace:
59
- `<YOUR_TOKEN>` with your claim token
60
- `<YOUR_ROOMS>` with your Room ID(s)
61
72
----
73
-
62
### Download & Install in One Command (PowerShell)
63
64
```powershell
65
$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest https://github.com/netdata/netdata/releases/latest/download/netdata-x64.msi -OutFile "netdata-x64.msi"; msiexec /qn /i netdata-x64.msi TOKEN=<YOUR_TOKEN> ROOMS=<YOUR_ROOMS>
66
```
67
80
----
81
-
68
## Graphical Installation (GUI)
69
70
1. Download the `.msi` installer.
@@ -86,8 +72,6 @@ $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest https://github.com/n
72
3. Grant Administrator privileges when prompted.
73
4. Complete the setup wizard.
74
89
----
90
-
75
## Access Netdata Dashboard
76
77
After installation, open your browser and go to:
@@ -96,11 +80,91 @@ After installation, open your browser and go to:
80
http://localhost:19999
81
```
82
99
----
100
-
83
## License Information
84
85
By using silent installation, you agree to:
86
87
- [GPL-3 License](https://raw.githubusercontent.com/netdata/netdata/refs/heads/master/LICENSE) — Netdata Agent
106
-- [NCUL1 License](https://app.netdata.cloud/LICENSE.txt) — Netdata Web Interface
\ No newline at end of file
88
+- [NCUL1 License](https://app.netdata.cloud/LICENSE.txt) — Netdata Web Interface
89
+
90
+## Automatic Updates
91
+
92
+For users who want to keep their Windows agents automatically updated with the latest releases, you can set up automated updates.
93
+
94
+:::tip
95
+
96
+**What You'll Learn**
97
+
98
+How to set up automatic Netdata updates on Windows nodes using PowerShell and Task Scheduler.
99
+
100
+:::
101
+
102
+### How to set up
103
+
104
+This setup will automatically download and install the latest Netdata build (stable or nightly) daily at your preferred time.
105
+
106
+**1. Create the directory and updater script**
107
+
108
+Run one of these PowerShell commands **as Administrator** (choose stable or nightly):
109
+
110
+:::info
111
+
112
+**Administrator Rights Required**
113
+
114
+Creating directories in ProgramData and running Task Scheduler with the highest privileges requires administrator access.
115
+
116
+Right-click on PowerShell and select "Run as administrator" before running these commands.
117
+
118
+:::
119
+
120
+- Stable version
121
+
122
+ ```powershell
123
+ New-Item -Path "$env:PROGRAMDATA\netdata" -ItemType Directory -Force
124
+ @'
125
+ Invoke-WebRequest https://github.com/netdata/netdata/releases/latest/download/netdata-x64.msi -OutFile $env:PROGRAMDATA\netdata\netdata-x64.msi
126
+ msiexec /qn /i $env:PROGRAMDATA\netdata\netdata-x64.msi TOKEN="<CLAIM_TOKEN>" ROOMS="<ROOM_ID>"
127
+ '@ | Out-File -FilePath "$env:PROGRAMDATA\netdata\netdata-updater.ps1" -Encoding UTF8
128
+ ```
129
+
130
+- Nightly version
131
+
132
+ ```powershell
133
+ New-Item -Path "$env:PROGRAMDATA\netdata" -ItemType Directory -Force
134
+ @'
135
+ Invoke-WebRequest https://github.com/netdata/netdata-nightlies/releases/latest/download/netdata-x64.msi -OutFile $env:PROGRAMDATA\netdata\netdata-x64.msi
136
+ msiexec /qn /i $env:PROGRAMDATA\netdata\netdata-x64.msi TOKEN="<CLAIM_TOKEN>" ROOMS="<ROOM_ID>"
137
+ '@ | Out-File -FilePath "$env:PROGRAMDATA\netdata\netdata-updater.ps1" -Encoding UTF8
138
+ ```
139
+
140
+:::info
141
+
142
+**Configuration Required**
143
+
144
+Replace `<CLAIM_TOKEN>` with your Netdata Cloud claim token and `<ROOM_ID>` with your room identifier.
145
+
146
+:::
147
+
148
+**2. Create an entry in `Task Scheduler`**
149
+
150
+| Tab | Setting | Value |
151
+|--------------|--------------------------------------|--------------------------------------------------------------------------------------|
152
+| **General** | Run whether user is logged in or not | ✓ Checked |
153
+| | Run with highest privileges | ✓ Checked |
154
+| | Configure for | Windows Vista, Windows Server 2008 |
155
+| **Triggers** | Schedule | Daily |
156
+| | Time | Your preferred time (e.g., 7AM UTC) |
157
+| **Actions** | Program/Script | `powershell` |
158
+| | Arguments | `-noprofile -executionpolicy bypass -file %PROGRAMDATA%\netdata\netdata-updater.ps1` |
159
+
160
+:::tip
161
+
162
+**Alternative Scheduling Options**
163
+
164
+Instead of daily updates, you might prefer:
165
+
166
+- Weekly updates (select "Weekly" in **Triggers tab**)
167
+- Multiple times per day for critical systems
168
+- Only on specific days of the week
169
+
170
+:::