@cryptotaxi247 / netdata / commits / dbd614467

docs: task class: improve_docs. add an 'offline/air-gapped windows (#22547)

* docs: update docs/netdata-windows-offline-air-gapped-deployment * docs: clarify offline installation platform notes * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Apply suggestion from @Ancairon * Apply suggestions from code review Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> * Apply suggestions from code review Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> * Update WINDOWS_INSTALLER.md * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: nedi-app[bot] <nedi-app[bot]@users.noreply.github.com> Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

nedi-app[bot] committed May 27, 2026 at 10:52 UTC dbd614467ee6b6a8eea4ed8be718af81041099c5
2 files changed +56
packaging/installer/methods/offline.md
+6
@@ -16,6 +16,12 @@ Local package tools like `apt-offline` may work for DEB/RPM installs — but we
16
17 :::
18
19 +:::note
20 +
21 +For offline installation on Windows, see [Install Netdata on Windows](/packaging/windows/WINDOWS_INSTALLER.md#offline-air-gapped-installation). This guide covers UNIX-like systems only.
22 +
23 +:::
24 +
25 ## Step 1: Prepare the Offline Installation Package
26
27 On your internet-connected machine, you'll need::
packaging/windows/WINDOWS_INSTALLER.md
+50
@@ -81,6 +81,56 @@ $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest https://github.com/n
81 3. Grant Administrator privileges when prompted.
82 4. Complete the setup wizard.
83
84 +## Offline (Air-gapped) Installation
85 +
86 +Use this method to install Netdata on a Windows system with no internet access.
87 +
88 +### Step 1: Download the MSI
89 +
90 +On an internet-connected machine, download the MSI installer using one of the links from the [Download the Windows Installer](#download-the-windows-installer-msi) table above.
91 +
92 +### Step 2: Transfer to the Offline System
93 +
94 +Copy the downloaded `.msi` file to the offline Windows system using a USB drive, network share, or other secure transfer method.
95 +
96 +### Step 3: Install Without Cloud Parameters
97 +
98 +Open a command prompt as Administrator and run a silent install **without** `TOKEN` or `ROOMS` parameters:
99 +
100 +```powershell
101 +msiexec /qn /i netdata-x64.msi
102 +```
103 +
104 +:::note
105 +
106 +This offline method uses `msiexec /qn` to install from a locally available MSI. On Windows Server versions earlier than 2019, the *automated download* commands in this document may fail due to TLS compatibility issues—download the MSI on another machine (Step 1) or use the [GUI installer](#graphical-installation-gui).
107 +
108 +:::
109 +
110 +In an air-gapped environment, Netdata Cloud features are unavailable. The Agent runs in standalone local mode.
111 +
112 +:::tip
113 +
114 +Paid/enterprise users can use the local Dashboard for full monitoring without Cloud connectivity.
115 +
116 +:::
117 +
118 +:::note
119 +
120 +Free users on standalone Agents have limited functionality — the UI is locked and there is no local monitoring. See [Limitations for Free Users](#limitations-for-free-users) for details.
121 +
122 +:::
123 +
124 +### Step 4: Access the Local Dashboard
125 +
126 +See [Access Netdata Dashboard](#access-netdata-dashboard).
127 +
128 +:::caution
129 +
130 +Automatic updates require internet access and are not possible on air-gapped systems. To update, repeat the transfer process with a newer MSI.
131 +
132 +:::
133 +
134 ## Access Netdata Dashboard
135
136 After installation, open your browser and go to: