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
