SoftTelRGWebSureQTool

Install and set up WebSureQTool on Windows (1.3.3)

Tags: install, setup, windows, microsoft store, webdriver, edge, chrome, msedgedriver, chromedriver, workspace, update, rollback

Follow this once and every later guide will just work. Each step below matches the actual 1.3.3 screens.

STEP 1 - Install the app
- Microsoft Store (recommended): open the WebSureQTool listing, click Install, and Windows handles the rest. Store installs also update automatically through the Store.
- Direct install: download the installer from the GitHub Releases page linked on the Download page. Direct installs get an in-app update notice when a new version is published (see "Updating" below).

STEP 2 - Create your workspace (first launch)
- Go to File > New Workspace...
- Choose a Root Folder you control. A common choice is a folder under your Documents, for example Documents\WebSureQTool\workspace.
- Keep "Create standard folders (drivers/projects/logs/reports)" checked and click Create.
- Everything you build - projects, suites, datasets, logs, reports - lives under this folder on your disk. Back it up like any other work folder.

STEP 3 - Import a WebDriver (required before your first run)
WebSureQTool automates real browsers through Selenium WebDriver, so it needs a driver executable that MATCHES your installed browser version.

- Open Tools > Import Driver...
- For Microsoft Edge: find your Edge version at edge://settings/help, download the matching msedgedriver.exe from Microsoft's "Microsoft Edge WebDriver" page, then in the dialog set Path (Browse), click Validate, then Save.
- For Google Chrome: find your Chrome version at chrome://settings/help, download the matching chromedriver.exe (Chrome for Testing downloads page), then set Path, Validate, Save.
- Validate is your friend: if it passes, your browser opens correctly later. If a run ever stops opening the browser after a browser auto-update, come back here and import the newer matching driver.

STEP 4 - Review Settings (optional but recommended)
- Open Tools > Settings... (Workspace & Paths).
- You will see Workspace Root plus Drivers Dir, Projects Dir, Logs Dir, and Reports Dir. Relative names resolve under the workspace root; absolute paths are supported for enterprise storage locations.
- The defaults are fine for most users. Restore Defaults brings back the standard folder names.

STEP 5 - Pick your mode and create a project
- Use the Mode menu to switch between Web Testing and API Testing.
- In the Project Explorer, click New Project, give it a name, and you are ready for the "Start here" guide and your first suite.

UPDATING (direct installs, 1.3.3+)
1. When the update notice appears - or anytime via Help > Check for Updates - select Download & update. Release notes are shown before anything downloads.
2. Download progress appears in the status bar. When prompted, select Apply & restart; the installer opens.
3. Close the WebSureQTool app window before continuing in the installer (check the taskbar).
4. Known 1.3.3 issue: if the app is still running, Windows may report "file is in use". Close the app, then click Retry in the installer - no reboot needed.
5. Your current version is backed up first, so you can revert. You can also skip a version or turn the startup check off.

ROLLING BACK
- Every release stays published on GitHub Releases. To move to an older version: Windows Settings > Apps > WebSureQTool > Uninstall, then run the older installer.
- Your suites, projects, datasets, and settings live in your workspace folder - not the install folder - and survive uninstall/reinstall.
Need the detailed workflow?

The public guide stays intentionally high level. Open the Intelligent Assistant for click-by-click instructions, learning order, and practice ideas.

Open Assistant