- Docs
- Administration
- Project settings
- Troubleshooting
Troubleshooting
Find the message or symptom you see. Each entry says why it happens, what to check and how to fix it.
In short
On this page you can
- Look up an exact Project Panel message and see what causes it.
- Fix start page URL, AI connection, mobile and desktop errors.
- Find out why a pipeline still runs with old settings.
- Understand why a value you typed was changed when you saved.
How to use it
- Copy the message you see, or describe the symptom.
- Find it under its area: access, project, run settings, AI, engines, mobile, desktop.
- Open the entry and follow Check, then Fix.
- Still stuck? Write to info@smartestqa.ai with the message and the project name.
Access#
Project Panel is greyed out: “Please contact your administrator to access this feature.”Access
- Why
- The Project Panel is for Admin and Super Admin. Opening its address with the User role leads to the unauthorized page.
- Fix
- Ask a company admin to change the setting, or to give you the Admin role in Company settings › Users. Roles: Who can do what.
Project Panel is missing from the menu, or “Please select a project”Access
- Why
- No project is selected. The panel always edits the selected project.
- Fix
- Pick a project in the header’s project list, or create one: Create a project.
“Are you sure to exit without saving?”Access
- Why
- You are leaving the page, or leaving Mobile Config or Desktop Configuration, with unsaved changes.
- Fix
- Save and Exit saves and continues; if the save fails you stay on the page. Exit without saving drops the changes. See Leaving with unsaved changes.
Project and start pages#
“This project name has already been used in this company. Please choose a different project name.”Project
- Why
- Project names are unique in a company, across all its admins.
- Fix
- Choose another name, for example with the team or app version. See Rename the project.
“Project name is required” or “Error updating project name”Project
- Why
- The field is empty, or the server did not accept the change (session expired, deleted project).
- Fix
- Type a name of up to 100 characters and save again. If it keeps failing, reload the page and sign in again.
“"name" could not be deleted. Please try again or contact support.”Project
- Why
- The server refused or did not finish the deletion: the project was already deleted, belongs to another company, or the request was interrupted.
- Check
- Reload the page. If the project is gone from the header’s list, the deletion went through.
- Fix
- Try again once. If it fails again, write to info@smartestqa.ai with the project name.
“Please enter a valid URL (e.g., https://example.com)”, “field must start with http:// or https://”, “field must not contain spaces.” or “field is not a valid URL.”Start pages
- Why
- A DEV, TEST or PRP address is not a full web address.
- Fix
- Paste the address from the browser’s address bar, starting with
https://, without spaces. See Add or edit a URL.
“Name is required.”, “Please enter a name” or “At least one URL (DEV, TEST, or PRP) is required.”Start pages
- Fix
- Give the start page a name and at least one address. Save stays greyed out until both are there.
“A Start Page with this name already exists…”, “field is already registered…”, “A URL is already registered for another Start Page in this project.” or “Duplicate detected for field…”Start pages
- Why
- In one project, names are unique and each address can be used by only one start page per environment.
- Check
- Search the list for the name or the address.
- Fix
- Edit the existing start page instead of adding a second one, or use another name. See Start page URLs.
“Project information is missing. Please refresh and try again.”, “Error saving URL”, “Could not set default URL.” or “"name" could not be deleted. Please try again.”Start pages
- Why
- The page lost track of the project, or the server did not accept the change.
- Fix
- Reload the page, check that the right project is selected, and try again.
“This URL is being used in other places. Deleting it will remove the URL reference from those items.”Start pages
- Why
- Test cases or pipelines start on this URL.
- Fix
- Click the line to see them. Prefer editing the address. If you delete, give those test cases and pipelines another start page. See Delete a URL.
“Export failed”Export
- Check
-
- Your session is still valid: reload the page.
- Another export is not still running (the buttons are greyed out while one runs).
- Your browser allows downloads from SmartestQA.
- Fix
- Try again. For a large project, try Export as JSON first. See Export the project.
Run settings#
A pipeline still runs with the old value after I changed Test ManagementRun settings
- Why
- A pipeline copies the project’s settings when it is created and then uses its own copy. Dry Runs use the project’s current values.
- Fix
- Open the pipeline in Schedule and change its run settings, or create it again. See How settings reach a run.
Thread Count goes back to a lower number when I type or saveRun settings
- Why
- Thread Count cannot exceed your licence’s Max Thread Count. The field and the server both cap it.
- Fix
- See your limit in License Details. For more threads, an Admin changes the licence in Billing or contacts SmartestQA. Formula: Thread Count.
Thread Count is greyed outRun settings
- Fix
- Turn on Parallel Execution. DESKTOP projects have no parallel block: their test cases run one after another.
Retry Count or a timeout changes after I type itRun settings
- Why
- Values are kept inside their range: Retry Count 0–5, Wait Timeout and Page Load Timeout 1–120 seconds, Max Tokens 1–8192, Temperature 0–1.
- Fix
- Enter a value inside the range. See Retry Count.
No report email arrives after a pipeline runRun settings
- Check
-
- Email Notification is on in the pipeline’s own settings (or, if the pipeline has none, in the project).
- When to Send is not On Failure for a run where everything passed.
- Email To is filled; addresses are separated by semicolons.
- The spam folder.
- Fix
- Correct the setting and run the pipeline again. See Email Notification.
Passed steps have no screenshot in pipeline reportsRun settings
- Why
- Screenshot On Fail is on: only failed steps keep a screenshot. Or Skip Successful Logs is on and passed steps have no log at all.
- Fix
- Turn them off in the pipeline’s settings for full evidence. Dry Runs always take a screenshot per step.
The app under test shows English dates or the wrong timeRun settings
- Why
- The browser runs with Browser Locale en-US, or (Playwright) with the default timezone Europe/Istanbul.
- Fix
- Set Browser Locale (for example
de-DE) and, for Playwright, Timezone. See Browser Configuration and Playwright Settings.
“An error occurred while saving project settings”Run settings
- Why
- The server did not accept the save: session expired, network error, or the project belongs to another company.
- Fix
- Reload the page (your unsaved values are lost), sign in again if asked, and save again.
“No changes to save”Run settings
- Why
- Every value equals the saved one. Changing a value and changing it back counts as no change.
AI#
Test Connection fails (“Connection failed” or one of the messages below)AI
- Why
- The provider refused the request. The message says why:
Message Fix “Enter this provider's API key first.” Paste the key. “Enter the Base URL of your local LLM server…” Fill Base URL for OpenAI-compatible / Local. “The API key was rejected by the provider…” Paste the whole key; check it belongs to this provider. “This model is no longer available…” Use the suggested model, or another one. “Your account does not have access to this model…” Pick another model or enable it in the provider console. “The provider account has no quota or credit left…” Check billing at the provider. “Too many requests to the provider.” Wait the time shown and try again. “This model does not accept the … setting…” Change Max Tokens or Temperature, or the model. “The model returned no answer — the token budget ran out…” Raise Max Tokens. “The provider's safety filter blocked the response…” Rephrase the prompt or the test data. “The provider did not respond in time.” / “The provider could not be reached…” Check Base URL, network and proxy; a local model must be reachable from the SmartestQA server. “The AI connection could not be completed…” Check provider, model and key; open Technical details. - More
- Fields: Use your own account.
An AI button is greyed out: “Enable '…' in Project Panel → AI Options”AI
- Why
- The feature needs Enable AI and, for some features, one capability switch.
- Fix
- Turn on the switch the tooltip names and save. Which switch unlocks what: AI Capabilities.
The API Key field is empty although a key was savedAI
- Why
- The saved key could no longer be read (the server’s encryption key changed). SmartestQA shows it empty rather than pretend it works.
- Fix
- Paste the key again, click Test Connection, then Save Changes.
Selenium and Playwright#
I don’t see Selenium Settings (or Playwright Settings)Engines
- Why
- Only the section of the selected engine is shown, and only in WEB projects.
- Fix
- Change Script Language, save, and the other section appears.
The proxy is not usedEngines
- Check
-
- The value has a port, for example
http://proxy:8080. Without one the run continues without a proxy and logs “Invalid proxy … running without a proxy”. - Playwright: the run is not Run on Server; the Playwright proxy applies on your agent only.
- The pipeline’s own settings contain the proxy (pipelines keep their copy).
- The value has a port, for example
- More
- How a proxy value is read.
The simulated location or a permission has no effectEngines
- Fix
- Add
geolocationto Permissions, lowercase, comma-separated. Unknown names are ignored with a warning in the run log. See Playwright Settings.
Runs became very slowEngines
- Check
- Slow Motion (ms) is above 0; Wait Timeout (sec) is high while elements are missing; Retry Count repeats failing cases.
- Fix
- Set Slow Motion to 0, lower the timeouts, and fix the failing steps.
Mobile#
Save Configuration is greyed out: “Select at least 1 test device for AWS Device Farm”, “… for BrowserStack” or “Plan limit exceeded…”Mobile
- Why
- The saved mode is AWS Device Farm or BrowserStack and no device is selected, or more BrowserStack devices are selected than your BrowserStack plan’s parallel sessions.
- Fix
- Open that mode’s card and select devices (or fewer). If you want local runs, click Local device before saving. See Save Configuration.
Mobile Config shows Local device although I use AWS or BrowserStackMobile
- Why
- The page opens on the Local device view. The saved mode is still the one you clicked last before saving.
- Fix
- Click your mode’s card, check its fields and save. See Execution modes.
“Could not load BrowserStack device list (credentials may be wrong or not yet saved)…”Mobile
- Fix
- Enter the user name and access key, click Save Configuration, then refresh the device list. Only 1 device can be picked until your BrowserStack plan has loaded. See BrowserStack.
“Upload failed: message” when uploading to AWS Device FarmMobile
- Why
- The server reads the keys and project name from the saved configuration. The message tells which part is missing: configuration not saved yet, AWS credentials missing, AWS project name missing, or an AWS error.
- Fix
- Fill the AWS fields, save, then upload again. Check the keys are allowed to use Device Farm in the chosen region. See AWS Device Farm.
“APK read failed”, “IPA read failed”, or the APK could not be parsedMobile
- Why
- The file is empty, larger than 200 MB, not an
.apkor.ipa, or not a valid app. - Fix
- Use the
.apkor.ipabuild file itself, not a ZIP of it. If it still fails, type App Package and App Activity, or Bundle ID, by hand. See Android Configuration.
“No devices found. Is the agent running on port 8000?…”, or the device picker says the agent was not foundMobile
- Why
- SmartestQA asks your agent for its connected devices. If the agent does not answer, the picker shows why; in some versions this text appears in Turkish, for example “SmartTest-Desktop bulunamadı…” (agent not found) or “Agent cevap vermedi…” (agent did not respond).
- Check
-
- The agent runs on this computer and is green in Test Agents.
- USB devices: USB debugging is on and the “Allow USB debugging” prompt on the phone was accepted.
- Simulators are booted.
- Fix
- Start the agent, connect the device, then click “Refresh device list”.
VPN Connectivity Test shows “Connection failed” or “Test could not run”Mobile
- Fix
- Read each failed check and its suggestion. BrowserStack Local: the BrowserStackLocal program must run with the same identifier. AWS VPC: VPC ID, at least one subnet and a security group are needed. See VPN status.
“Failed to save mobile configuration” or “Failed to load mobile configuration”Mobile
- Fix
- Reload the page and try again. If it keeps failing, write to info@smartestqa.ai with the project name.
Desktop#
“Appium Server URL is not valid (e.g. http://localhost:4723)”Desktop
- Fix
- Use
http://host:port, for examplehttp://localhost:4723, or leave it empty for the default. See General Settings.
“An application with this name already exists”, “Name is required” or “Fill in AUMID / Bundle ID or App Path”Desktop
- Fix
- Use a name not yet in the list (case does not matter) and fill the AUMID or bundle ID, or the app path. See Applications.
“No application yet: add one under Applications so tests can open the app”Desktop
- Why
- The project has no application in the list. The configuration was still saved.
- Fix
- Click Add application, or Save current as application if it is offered.
“Failed to save desktop configuration”, “Application could not be saved”, “Application could not be deleted” or “Applications could not be loaded”Desktop
- Fix
- Reload the page and try again. A server reason, if any, is shown after the message.
Didn’t find your answer?Write to support with your project name and what you see on screen.
info@smartestqa.ai