diff --git a/docs/getting-started/clients/desktop/index.mdx b/docs/getting-started/clients/desktop/index.mdx index f8e80a24b..91dc2f666 100644 --- a/docs/getting-started/clients/desktop/index.mdx +++ b/docs/getting-started/clients/desktop/index.mdx @@ -142,3 +142,23 @@ versions to these solved this issue: - Node: `16.18.1` - npm: `8.19.2` + +### Windows build installation fails + +When installing standard/beta builds (not portable) for the Windows platform from build artifacts, +there are additional steps required. Without following the steps, the following failure occurs: + +![`nsis` error](./nsis-error.png) + +Steps: + +1. Download the standard / beta Windows build (the `.exe` from figure below) +2. Download the corresponding `.nsis.7z` file (also seen in figure below) +3. Place the `.nsis.7z` file in the same directory as the installer (this might require + decompressing the download) + +![`nsis` build files](./nsis-build-files.png) + +The final directory state before starting the install should look like this: + +![`nsis` and exe directory](./nsis-exe-dir.png) diff --git a/docs/getting-started/clients/desktop/nsis-build-files.png b/docs/getting-started/clients/desktop/nsis-build-files.png new file mode 100644 index 000000000..dbec16612 Binary files /dev/null and b/docs/getting-started/clients/desktop/nsis-build-files.png differ diff --git a/docs/getting-started/clients/desktop/nsis-error.png b/docs/getting-started/clients/desktop/nsis-error.png new file mode 100644 index 000000000..db82312fb Binary files /dev/null and b/docs/getting-started/clients/desktop/nsis-error.png differ diff --git a/docs/getting-started/clients/desktop/nsis-exe-dir.png b/docs/getting-started/clients/desktop/nsis-exe-dir.png new file mode 100644 index 000000000..88f185308 Binary files /dev/null and b/docs/getting-started/clients/desktop/nsis-exe-dir.png differ