Skip to content

Fix device agent setup for windows PowerShell instructions in quickstart.md - #8018

Merged
Steve-Mcl merged 4 commits into
mainfrom
Steve-Mcl-patch-1
Jul 31, 2026
Merged

Fix device agent setup for windows PowerShell instructions in quickstart.md#8018
Steve-Mcl merged 4 commits into
mainfrom
Steve-Mcl-patch-1

Conversation

@Steve-Mcl

Copy link
Copy Markdown
Contributor

Description

Updated instructions for windows running the installer in the quickstart guide.

In short, when the elevated command is ran, the new terminal always opens in c:\windows\system32. This will cause the downloads to occur in the system32 dir - if even permitted (depends on how terminal was fired up and by who). Essentially, this can lead to System errors (Access Denied) or stale versions running if previously executed.

The solution is to ensure the user dir is first selected before any web downloads occur.

Related Issue(s)

Checklist

  • I have read the contribution guidelines
  • Suitable unit/system level tests have been added and they pass
  • Documentation has been updated
    • Upgrade instructions
    • Configuration details
    • Concepts
  • Changes flowforge.yml?
    • Issue/PR raised on FlowFuse/helm to update ConfigMap Template
    • Issue/PR raised on FlowFuse/CloudProject to update values for Staging/Production
  • Link to Changelog Entry PR, or note why one is not needed.

Labels

  • Includes a DB migration? -> add the area:migration label

Updated instructions for windows running the installer in the quickstart guide
@Steve-Mcl

Steve-Mcl commented Jul 31, 2026

Copy link
Copy Markdown
Contributor Author

@hardillb do you have a windows installation you can test this on?

Comment thread docs/device-agent/quickstart.md Outdated
@Steve-Mcl
Steve-Mcl requested a review from hardillb July 31, 2026 12:49
@hardillb

Copy link
Copy Markdown
Contributor

do you have a windows installation you can test this on?
@Steve-Mcl Not really

I have my windows box I use for my indoor cycling that I'd rather not stick work stuff on and a absolute minimum Windows 10 VM that I setup for the S7 config stuff.

@Steve-Mcl

Copy link
Copy Markdown
Contributor Author

@hardillb vm is fine - if you can.

once tested, you can run it (the exe) again --uninstall to get rid of the service it will install

Comment thread docs/device-agent/quickstart.md Outdated
Added instructions for opening PowerShell with elevated permissions on Windows.
@Steve-Mcl
Steve-Mcl merged commit 6e97140 into main Jul 31, 2026
15 checks passed
@Steve-Mcl
Steve-Mcl deleted the Steve-Mcl-patch-1 branch July 31, 2026 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants