From e0a59b51c688900d4ef2ecdf400fe3a3eb343d6f Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 15 Jul 2026 09:08:31 +0000 Subject: [PATCH 1/2] Update Windows native install to use one-liner silent install command The Viam app now generates a single Command Prompt one-liner for Windows viam-agent installation (app#12694) instead of directing users to download the MSI and click through the wizard. Update the docs to match: show the command that fetches config, downloads the MSI, and runs a silent install with msiexec /qn /norestart. Co-Authored-By: Claude Opus 4.6 (1M context) Claude-Session: https://claude.ai/code/session_01BCPjBhmwapYtVuNM36gNp1 --- docs/reference/viam-server.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/reference/viam-server.md b/docs/reference/viam-server.md index e4e7f23205..9cef464447 100644 --- a/docs/reference/viam-server.md +++ b/docs/reference/viam-server.md @@ -398,7 +398,14 @@ curl https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-serv {{% /tab %}} {{% tab name="Windows native" %}} -Manual installation is not available for native Windows; you must download the [Viam Agent installer](https://storage.googleapis.com/packages.viam.com/apps/viam-agent/viam-agent-stable-windows-x86_64.msi) and follow the on-screen instructions to complete the installation. +To install `viam-agent` on native Windows, open **Command Prompt as administrator** and run the following command, replacing ``, ``, and `` with the values from your machine's **CONNECT** tab in the [Viam app](https://app.viam.com): + +```bat {class="line-numbers linkable-line-numbers"} +mkdir C:\etc 2>nul & curl -fsSL -H "key_id:" -H "key:" "" -o C:\etc\viam.json && curl -fsSL "https://storage.googleapis.com/packages.viam.com/apps/viam-agent/viam-agent-stable-windows-x86_64.msi" -o "%TEMP%\viam-agent.msi" && msiexec /i "%TEMP%\viam-agent.msi" /qn /norestart +``` + +This command fetches the machine configuration, downloads the installer, and installs `viam-agent` silently. +Use Cmd, not PowerShell. The `viam-agent` and `viam-server` binaries are installed at C:\opt\viam\cache. From 6bbc224c77d60bac032f34b6ec11dbc80467bc93 Mon Sep 17 00:00:00 2001 From: Brandon Shrewsbury Date: Fri, 17 Jul 2026 13:40:09 -0600 Subject: [PATCH 2/2] Point placeholder values at sources that actually provide them The CONNECT tab offers API keys but no config URL, so the instruction to take all three values from it left readers stranded. Inline the config URL shape (only the part ID varies), link the API keys page, and reuse the canonical status-dropdown instruction for copying the part ID. --- docs/reference/viam-server.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/reference/viam-server.md b/docs/reference/viam-server.md index 9cef464447..4481ca2323 100644 --- a/docs/reference/viam-server.md +++ b/docs/reference/viam-server.md @@ -398,10 +398,12 @@ curl https://storage.googleapis.com/packages.viam.com/apps/viam-server/viam-serv {{% /tab %}} {{% tab name="Windows native" %}} -To install `viam-agent` on native Windows, open **Command Prompt as administrator** and run the following command, replacing ``, ``, and `` with the values from your machine's **CONNECT** tab in the [Viam app](https://app.viam.com): +To install `viam-agent` on native Windows, open **Command Prompt as administrator** and run the following command. +Replace `` and `` with an [API key](/organization/api-keys/) that can access your machine, and `` with your machine part's ID. +To copy the part ID, click the **Live** / **Offline** status dropdown at the top of your machine's page, then click **Part ID**. ```bat {class="line-numbers linkable-line-numbers"} -mkdir C:\etc 2>nul & curl -fsSL -H "key_id:" -H "key:" "" -o C:\etc\viam.json && curl -fsSL "https://storage.googleapis.com/packages.viam.com/apps/viam-agent/viam-agent-stable-windows-x86_64.msi" -o "%TEMP%\viam-agent.msi" && msiexec /i "%TEMP%\viam-agent.msi" /qn /norestart +mkdir C:\etc 2>nul & curl -fsSL -H "key_id:" -H "key:" "https://app.viam.com/api/json1/config?id=&client=true" -o C:\etc\viam.json && curl -fsSL "https://storage.googleapis.com/packages.viam.com/apps/viam-agent/viam-agent-stable-windows-x86_64.msi" -o "%TEMP%\viam-agent.msi" && msiexec /i "%TEMP%\viam-agent.msi" /qn /norestart ``` This command fetches the machine configuration, downloads the installer, and installs `viam-agent` silently.