Troubleshooting

Troubleshooting

Most issues fall into a handful of categories. Work through the entries below before contacting support — each one lists the symptom, the usual cause, and the fix.

The installer does not start

  • Symptom: nothing happens when you run the installer.
  • Cause: Windows SmartScreen or an endpoint security tool is blocking an unrecognised publisher.
  • Fix: open the file properties, choose Unblock, then run it again as administrator.

The agent cannot read my project

  • Symptom: file reads fail or return nothing.
  • Cause: the folder is outside the approved workspace or is protected by system permissions.
  • Fix: move the project to a normal user folder and reopen it as the workspace root.

Changes are rejected or not applied

  • Symptom: proposed edits do not appear on disk.
  • Cause: the file is open and locked in another editor, or the write was declined.
  • Fix: close the file in other tools and re-run the step, then approve the change.

Still stuck?

Send the details to contact@harnesslaunch.com including what you did, what you expected, and the exact error text.