Skip to content

Quick Start Guide

This guide will help you get started with installing and configuring the app.


The app requires that you have hosted Home Assistant somewhere in your network or accessible from the internet.

The app currently only supports the Meta Quest 2, Pro and 3, other headsets like Pico 4 might work but are not officially supported yet.


You can download the app from the following sources:


The app is free to use, but if you want to support the project, you can buy it from the Meta App Lab or The benefit of buying it from the App Lab is that you will get automatic updates.

Installation to the Headset

If you bought the app from the Meta App Lab, you can skip this step.

In order to install the app on your headset, you will need to use SideQuest to install APK files to the headset.

  1. Download the APK from the source you chose.
  2. Connect your headset to your computer.
  3. Open the SideQuest app.
  4. Drag and drop the APK file into the SideQuest window.

Creating a Token to access Home Assistant

In order to access your Home Assistant instance from the app, you will need to create a Long-Lived Access Token.

In the Home Assistant Dashboard, do the following:

  1. Click on your user profile in the bottom left corner.
  2. Scroll to the bottom and click on create token under "Long-Lived Access Tokens".


You can use a pastebin like to access your token from the headset. Simply paste the token and click Save. You can then access the token from the headset using the URL you got redirected to. E.g. /upload/ can be replaced with /u/.

Home Assistant Dashboard

  1. Open the Menu in the app and open the settings panel by either:
    • Pressing the Menu button on the left controller.
    • making the pinch gesture with the left hand while you palm points into your direction.
  2. Enter the URL of your Home Assistant instance and the token you just created. Make sure to change http -> ws or https -> wss in the URL.


If you have used a pastebin to store your token, open the Browser on your headset and enter your pastebin URL. You can then copy the token from there.

  1. Finally, by clicking the Connect button, the app will try to connect to your Home Assistant instance. If everything is correct, you will see the text change to Connected below the button.

Setting Panel in the app

What's next?

You successfully connected the app to Home Assistant. Next up you have to configure the rooms, read more about it in the Room Setup section.


Rooms have to be configured first, before you can add entities to them.