Troubleshooting

Troubleshooting

Most issues fall into a handful of categories. Work through the entries below before you contact 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 your endpoint security tool is blocking a publisher it doesn’t recognise.
  • Fix: open the file’s properties, choose Unblock, then run the installer again as administrator.

The agent cannot read my project

  • Symptom: file reads fail or come back empty.
  • Cause: the folder sits outside the approved workspace, or system permissions protect it.
  • Fix: move the project into a normal user folder and open it again as the workspace root.

Changes are rejected or not applied

  • Symptom: proposed edits don’t show up on disk.
  • Cause: the file is open and locked in another editor, or the write was declined.
  • Fix: close the file in the other tool, run the step again, then approve the change.

Still stuck?

Send the details to [email protected]. Tell us what you did, what you expected, and paste the exact error text.