Spatial Homelab
Support
Getting started, what you need, and how to reach us. Get Spatial Homelab on the App Store.
What you need
- Apple Vision Pro running visionOS 26 or later.
- For TrueNAS: a TrueNAS SCALE server on your network and an account with the Read-only Admin role (Credentials › Groups › Privileges). The app signs in with your password and creates an API key named Spatial Homelab. If the account cannot create keys, the app offers to store the password instead, or you can paste an API key. When adding the server, Advanced › Accept self-signed certificate is on; turn it off if the server has a trusted certificate.
- For UniFi: an API key made in the console's portal under Integrations, for Local Console, or an API key from unifi.ui.com, for Site Manager. A key from the Network app's settings does not work, and the two kinds are not interchangeable. Local Console is faster and needs you on the console's network or its VPN. Site Manager works from anywhere and reads one site in full, or every site's totals together with All Sites.
- For Apple Home: a home set up in the Home app, signed in with the same Apple Account.
Getting started
- Tap + and, under Add Server, choose TrueNAS Server, UniFi Controller, or HomeKit Home. + › Instructions walks through each one.
- Tap + › Add Panel, or New Panel in a server's ⋯ menu. Ask AI, start from a preset, or build your own. The preview shows the panel as you change it. Tap Add to keep it.
- Drag a panel anywhere in the room. It stays there.
- Tap a count on a panel to see what it counts. It opens as a panel of its own; tap Add to keep it on the dashboard. On your own servers this is part of Pro and the trial; on the demo servers it is free.
- Want to look first? + › Demo Servers adds a demo TrueNAS, UniFi, and home with panels ready.
Ask AI (Beta)
Choose Ask AI when adding a panel, then type or tap the microphone and say what you want to see, such as "I'm cold" or "Is anything offline?" Select a result to try it on, then tap Add. Part of Pro and the trial.
- Ask AI needs Apple Intelligence. Turn it on in Settings, under Apple Intelligence & Siri.
- Choose Private Cloud Compute or On Device. Private Cloud Compute is available on visionOS 27 and later.
- Speaking asks for microphone and speech recognition permission the first time.
Widgets
- In the Home View, open Widgets and choose Spatial Homelab.
- Choose Large or Extra Large, select Add Widget, and place it on a wall.
- To choose what it shows, pinch and hold the widget, then select the settings button at the top, and choose a panel.
- Tap a widget to open its panel. Widgets update every second while the app is open, and about every 15 minutes when it isn't.
Alerts
In a server's ⋯ menu, choose Turn On Alerts and allow notifications. You get a notification when something on that server breaks, such as a degraded pool, a device going offline, or a low battery, and another when it recovers. Part of Pro, for your own servers.
Siri and Shortcuts
- "Is anything wrong in Spatial Homelab?" checks every server and says only what is wrong.
- "Check panel in Spatial Homelab" says what a panel shows now.
- "Open panel in Spatial Homelab" opens it.
- Use any words from the panel's name, such as "Check pool in Spatial Homelab". All three are also in the Shortcuts app.
Controls
On a light's own panel, tap its state to switch it and drag the brightness. Fans and outlets switch the same way. On a list, tap a name to open it and tap its state to switch it; All On and All Off switch the whole list. Thermostats, locks, doors, and alarms are shown and never changed.
Free, trial and Pro
The free version keeps one real panel open, plus every demo panel. Pro unlocks unlimited panels on every server and home.
- Free trial. Tap Start 7-Day Free Trial on the Pro sheet. Nothing is charged when it ends, and the free version keeps working. The trial is offered once per device, including after reinstalling.
- Pro. One purchase, shared with your family through Family Sharing. No subscription.
- Restore Purchases. On a new device or after reinstalling, tap Restore Purchases in About or on the Pro sheet.
If something is wrong
The panel says Offline
Check the address and that the server is reachable from this device.
HomeKit shows nothing
Open Settings › Privacy & Security › HomeKit and make sure Spatial Homelab is allowed. Values can take a few seconds to arrive the first time.
A camera says Waiting for a picture
A HomeKit camera must be reachable in the Home app. A UniFi Protect camera needs Protect running on the console.
A UniFi server asks to be removed and added again
Servers added through Site Manager before version 1.1 read less. Remove the server from its ⋯ menu, then add it again and choose its site.
Ask AI says Apple Intelligence is turned off
Turn it on in Settings, under Apple Intelligence & Siri, then try again.
A panel closed on its own
visionOS allows a limited number of windows per app. Opening another panel past the limit closes the one opened longest ago. Close panels you are not using from the dashboard.
Contact
Email is the fastest way to reach us. Include your visionOS version and which server type you are connecting to.