> For the complete documentation index, see [llms.txt](https://mozarkdocs.gitbook.io/appx_documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mozarkdocs.gitbook.io/appx_documentation/test-infrastructure-documentation/troubleshooting-and-faqs.md).

# Troubleshooting & FAQs

## Troubleshooting & FAQs

Use this page to resolve common issues with login, sessions, devices, files, and scheduled tests.

### Login and access

<details>

<summary>I click Login but nothing happens, or I keep getting redirected back to the login page.</summary>

This usually means the SSO session expired or the browser is blocking cookies needed for the redirect.

Try these steps:

1. Clear cookies for the portal domain and `auth.mozark.ai`.
2. Allow cookies for Mozark domains.
3. Try an incognito or private window.
4. Disable extensions that could block redirects.

If the issue continues, contact your IT administrator.

Your account could be locked, or your organization's SSO configuration could need attention.

</details>

<details>

<summary>I cannot log in and see an invalid credentials error.</summary>

Verify that you are using the email address your account was created with.

Do not use an alias unless it is the primary account email.

If you recently changed your password, use the new one.

If the issue continues, use the password reset flow or contact your administrator.

</details>

<details>

<summary>I can log in, but I do not see any projects in the selector.</summary>

Your account may not be assigned to any projects.

Ask your Mozark account administrator to confirm your organization, app, and project membership.

</details>

### Sessions and devices

<details>

<summary>I cannot see any devices in the device list.</summary>

Your account may not be assigned to any projects, or no devices may be assigned to those projects.

Ask your platform administrator to verify both project membership and device assignment.

</details>

<details>

<summary>I launched a web session, but I was not redirected anywhere.</summary>

This usually means the platform could not allocate capacity or a network error interrupted the launch.

Check for an error toast.

If you see a launch failure, wait a few minutes and try again.

If the problem continues, contact support.

</details>

<details>

<summary>The live video stream is stuck or keeps showing a loading spinner.</summary>

Try these steps:

1. Refresh the page.
2. Check the browser console for WebRTC errors.
3. Verify that your firewall or VPN is not blocking WebRTC or KVS WebSocket traffic.
4. Try Chrome or Edge.

If the issue continues, the controller for that device could be offline.

Contact your platform administrator.

</details>

<details>

<summary>My interaction taps are landing in the wrong position on the device.</summary>

Set browser zoom to `100%`, then refresh the session.

Use `Ctrl+0` on Windows or `Cmd+0` on macOS.

Tap calibration depends on the rendered video frame size matching the displayed size.

</details>

<details>

<summary>My automated test failed immediately with a device not found or ADB error.</summary>

The device may have disconnected after selection but before the test started.

Check the device status in **Management → Devices**.

If it shows unavailable, there is likely a controller-side connectivity issue.

</details>

<details>

<summary>My session ended unexpectedly.</summary>

Sessions can end automatically because of idle timeout or maximum session duration.

Idle timeout is typically 10 minutes.

Check the Session Details page for the end reason.

If there is no timeout-related reason, the device may have gone unavailable during the session.

</details>

<details>

<summary>My session does not appear in the Sessions list.</summary>

Verify that the current **Organization → App → Project** matches the context used when the session was launched.

Also confirm that you are on the correct session tab, such as Web, Mobile, TV, or the relevant automation framework.

</details>

<details>

<summary>The session summary shows no results for my test.</summary>

Clear active filters and confirm you are in the correct project.

Then search by the test ID shown in the launch confirmation.

Date filters can also hide expected results.

</details>

<details>

<summary>The Video tab shows no recording available for a session that should have been recorded.</summary>

Wait one to three minutes after the session ends, then refresh the page.

If the recording is still missing after 10 minutes, the session may not have generated one.

Some session types do not guarantee recordings.

</details>

<details>

<summary>I cannot edit the session name or tags.</summary>

Edit session names and tags from the Sessions list.

Use the inline controls in the name and tags cells.

The Session Details page does not support those edits.

</details>

### File Management

<details>

<summary>I uploaded a file, but it does not appear in the test configuration dropdown.</summary>

Files are scoped to a project and framework.

Verify that the file was uploaded to the correct project and matches the selected framework type.

</details>

<details>

<summary>My file upload failed midway.</summary>

Check your internet connection and try again.

Large uploads need a stable connection for the full transfer.

If uploads fail consistently at a similar size, contact support to confirm whether a plan-specific upload limit applies.

</details>

<details>

<summary>The file I uploaded still shows re-signing after more than 10 minutes.</summary>

Refresh the file list first.

If the status does not change, delete the file and upload it again.

If the issue repeats, contact Mozark support.

</details>

### Scheduling

<details>

<summary>My scheduled test did not run at the configured time.</summary>

Check **Management → Jobs** to confirm that a job was created.

If no job appears, the schedule may be paused.

If the job exists but failed, open its details to review the failure reason, such as device unavailable or build not found.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mozarkdocs.gitbook.io/appx_documentation/test-infrastructure-documentation/troubleshooting-and-faqs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
