> For the complete documentation index, see [llms.txt](https://docs.v-nova.com/technologies/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.v-nova.com/technologies/immersix/troubleshoot-guide.md).

# Troubleshoot guide

Welcome to the ImmersiX Troubleshooting Guide. This guide aims to help you identify and resolve common issues you might encounter while using the ImmersiX application. Whether you're facing performance issues, initialization errors, or playback difficulties, this guide provides solutions to enhance your playback experience. For further assistance, please contact our support team.

{% hint style="warning" %}
If you are experiencing issues with your headset or its connection to the PC, please refer to the instructions from the headset manufacturer. For Meta Quest devices, you can find more information in the Meta Quest [Help Centre](https://www.meta.com/en-gb/help/quest/).
{% endhint %}

{% hint style="info" %}
Question? We're happy to help! Please [Contact us](/technologies/immersix/contact-us.md).
{% endhint %}

### Performance issue detected

The application has detected a performance issue which may effect your playback experience. We recommend checking out our [Performance guide](/technologies/immersix/performance-guide.md) to improve your immersive experience.

<figure><img src="/files/95171nlUwkJ9OLUIaKTP" alt=""><figcaption></figcaption></figure>

### No audio device found: Could not initialize scene audio manager

The application could not find an active audio device. Please plug in an audio device.

### VR initialization error -2: Could not create OpenXR instance

If an OpenXR instance cannot be created when launching the ImmersiX application, the Meta Quest Link application is not running. Please refer to step 3 in [Getting started](/technologies/immersix/getting-started.md) to install and set up the Meta Quest Link before starting the ImmersiX application.

<figure><img src="/files/SpFKTfJFQEvRMh0bPAT5" alt="Error message stating OpenXR is not initialised."><figcaption><p>OpenXR error (-2)</p></figcaption></figure>

### VR initialization error -4: No OpenXR headset or system found

If no OpenXR headset or system is found when launching the ImmersiX application, the Meta Quest Link application is not set-up correctly. Please refer to steps 4-6 in [Getting started](/technologies/immersix/getting-started.md) to set up the Meta Quest Link before starting the ImmersiX application.

<figure><img src="/files/0jMeDWNhjIM4QxmZOs9P" alt=""><figcaption><p>OpenXR error (-4)</p></figcaption></figure>

### GPU warning

The ImmersiX app requires an NVIDA graphics card (GPU) with the minimum recommended GPU being an NVIDIA GeForce GTX 1080 Ti (see [System requirements](/technologies/immersix/system-requirements.md) for more details). If this warning is shown, your system does either not include an NVIDIA GPU or the available GPU does not meet the minimum system requirements. You will likely observe playback issues when using the ImmersiX application.

<figure><img src="/files/Lpkre52HD6WbXoEirbeK" alt=""><figcaption><p>GPU warning</p></figcaption></figure>


---

# 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://docs.v-nova.com/technologies/immersix/troubleshoot-guide.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.
