- Docs
- Get started
- Quick Start
- Connect your app
Connect your app
Before SmartestQA can record, it needs a way into your app and the address to open.
In short
On this page you can
- Install the SmartestQA browser extension in Chrome or Edge.
- Add a start page URL with one address per environment: DEV, TEST, PRP.
- Set up mobile apps in Mobile Config and desktop apps through an agent.
- Decide whether you need an agent, then install one.
- Learn when an agent counts as Online, with a worked example.
How to use it
- Click Add to Chrome, pin the extension and refresh open SmartestQA tabs.
- In Start Page URLs, click + Add, enter a Name and the environment URLs.
- Mark the main start page with Set as default.
- Need an agent? Get it from Download Client and paste the host’s API key.
- Wait until the host’s dot turns green with Online.
SmartestQA needs two things before it can record: a way into the app, and the address to open. For web apps that is the browser extension plus a start page URL. Mobile and desktop apps connect through the agent.
Install the browser extension (web)#
Add it from the Chrome Web Store
Open SmartestQA in the Chrome Web Store and click Add to Chrome. The same listing works in Edge.
Pin it
Click the puzzle icon in the browser toolbar and pin SmartestQA so you can see it is active.
Refresh the SmartestQA tab
Press F5 on every SmartestQA tab that was already open. A newly installed extension cannot talk to tabs that were open before it was installed.
The Connect step of the Setup Roadmap moves forward, and recording buttons open a new tab instead of the Web Store.
How the app knows the extension is there
When you start a recording, the page sends the extension a ping and waits 1.2 seconds for an answer. No answer means “not installed”: the Web Store opens in a new tab, and when you come back the page reloads and starts the recording by itself. If it still gets no answer after that reload, you see “Browser extension still not detected.” See the fix.
Add a start page URL (web)#
A start page URL is a named address with one value per environment. Recording, AI generation and new test cases open it.
Open the list
Go to ConfigurationProject PanelStart Page URLs and click + Add. You can also use Manage URLs next to any start page selector.
Fill in the addresses
Give it a Name and at least one of DEV Environment URL, TEST Environment URL, PRP Environment URL. Addresses must start with
http://orhttps://and contain no spaces.Name DEV TEST PRP Login https://dev.portal.example.com/loginhttps://test.portal.example.com/loginleave empty Set as default
Mark the one most tests start from with Set as default. New test cases, pipelines and AI use it.
Environments are DEV, TEST and PRP
PRP is the production-side environment. Runs default to TEST. An environment with no URL is greyed out in recording settings with “No URL defined for this environment”. Keep PRP empty unless you really mean to test production.
Mobile and desktop apps#
| Project type | Do this | Where |
|---|---|---|
| MOBILE | Choose where the app runs: Local device (through your agent), AWS Device Farm, BrowserStack or SmartTest Device Farm (an add-on; shows “Locked — upgrade plan” without it). Then upload the APK or IPA. | ConfigurationProject PanelMobile Config |
| DESKTOP | Install the agent on the Windows or macOS computer that has the app and Appium (with the Windows driver or the Mac2 driver). Then configure the desktop application and mark one as default. | Device FarmTest AgentsDownload Client, then Desktop Configuration |
Do you need an agent?#
An agent is a small program you install on a computer you control. It runs tests there and streams the results back. You only need one when SmartestQA’s own servers cannot reach your app, or when the test needs a device or desktop app.
| Your situation | Run tests with | Agent needed? |
|---|---|---|
| Web app reachable from the internet | Run on Server: headless on the Smartest Server, always online | No |
| You want to watch the browser while a test runs | Run on your Agent on your own computer | Yes, on your machine |
| Web app behind a VPN, firewall or on an intranet | An agent on a machine inside that network | Yes, inside the network |
| Mobile app on a local phone or emulator | An agent on the computer the device is plugged into | Yes |
| Desktop app | An agent on the Windows or macOS computer with the app | Yes, next to the app |
| Runs started from CI/CD | Self-hosted runners (admin page Runners, token based) | A runner instead |
Install an agent#
Open Test Agents
Go to Device FarmTest Agents. Under Localhost you already have a host named after your email address. Each user gets one automatically. Use New Host only for shared machines such as a VM (names must be unique in the company).
Download the client
In the Download Client tab pick Windows, Mac or Linux and unzip the file. On servers, the Install Via CLI tab gives a one-line command that already contains the API key.
Give it the API key
Copy the key with the Copy API Key icon on the host row and paste it when the agent asks. Each host has its own key.
Wait for green
Leave the agent running. The page refreshes host status every 5 seconds.
The dot next to the host turns green and pulses with Online. Grey means Offline.
Online = the agent holds an open connection AND sent a heartbeat in the last 90 s Offline = connection closed, OR no heartbeat for 90 s (checked every 30 s) Heartbeat: every 5 s while the agent runs
Example: a laptop with an agent goes to sleep at 10:00:00. Its last heartbeat was 09:59:58. The next sweep after 10:01:28 marks it Offline, so the dot turns grey between about 10:01:28 and 10:01:58. Pipelines that start in that window and target it fail with “The following agent(s) are currently offline”.
When the SmartestQA backend restarts, every host is set to Offline until its agent reconnects, which running agents do on their own.
Didn’t find your answer?Write to support with your project name and what you see on screen.
info@smartestqa.ai