1. Run HOS Locally

Install and open Haptique OS on a Mac, PC, mini PC, NAS, or always-on server on your home network. Use the packaged HOS app when available.

Find the HOS address:

• http://192.168.1.50:8080 (replace with your HOS machine IP)
• http://haptique-os.local:8080 (if your network supports it)
• http://localhost:8080 (from the HOS machine itself)

From your phone browser, open the HOS IP address once to confirm it loads. Check which port HOS loaded on before continuing. The RS90 Change Server screen adds port 8080 automatically, so keep HOS reachable on port 8080 for this RS90 setup flow. If HOS starts on another port, such as 8081, free port 8080 or configure HOS to use 8080 before pairing the RS90.

2. Switch the Config App

Open the same Haptique Config app you already use, then change the server to your HOS address.

1. Tap the option to change server.
2. Enter the HOS machine IP address in the IP address box, for example 192.168.1.50.
3. Keep the port as 8080 for RS90 local pairing.
4. Create a local HOS account or sign in to an existing local HOS account.

3. Switch the RS90

Point the physical RS90 to the same local HOS server, then pair it from the Config app.

1. On the RS90 Quick Settings screen, tap Change Server.
2. Enter only the HOS machine IPv4 address, for example 192.168.1.50.
3. Do not add http:// or a port. The RS90 adds port 8080 automatically.
4. Use the Config app to scan the RS90 QR code.

Local Account

The local HOS server has its own account database. Create the account from the mobile Config app or HOS dashboard after switching the app to the local server.

• Use email and password for local HOS.
• Use your Fleet account when the app is pointed to Fleet cloud.
• Do not expect Google, Apple, or other social login buttons to work against local HOS.

License

A license is not required just to point the RS90 and Config app at a local HOS instance. A license may unlock advanced HOS capabilities such as premium integrations, AI features, remote access, or other Pro features.

Stable Address

Give the HOS machine a stable address so the RS90 and Config app do not lose it after a router restart.

• Reserve the HOS machine IP address in your router.
• Keep the HOS machine awake and on the same LAN as the RS90.
• Use Ethernet for the HOS machine when possible.
• Use the numeric IP address if haptique-os.local does not resolve.

Offline Behavior

Local mode reduces cloud dependency, but not every feature is offline. Local device control can continue when the device integration is local. Internet services, remote access, updates, cloud AI, licensing checks, and cloud-only integrations may still need internet.

Unlocked with HOS

HOS owns the device logic. RS90 gets the control surface.

• HOS devices can appear under the HOS category in My Devices.
• Favorites decide what appears quickly on RS90.
• Commands route back through the local HOS controller.

Fleet Release

A Fleet Release decides which HOS Logical Devices become available to RS90. Keep the first release small: one room, a few proven devices, then expand after real RS90 control works. For more information, see haptique.io/docs.

• Select stable Logical Devices.
• Assign RS90-compatible categories.
• Submit or sync the release.
• Check My Devices → HOS in the Config App.

HOS Devices

After the release is synced, the exposed devices appear in the existing Config App under the HOS category.

• Open My Devices in the Config App.
• Tap the HOS category chip.
• Heart the devices you want close on RS90.
• Test each favorite from the physical remote.

Fleet and HOS Stay Separate

HOS local mode does not replace the Fleet cloud product. Fleet remains available for hosted deployments. HOS gives you a local controller path when you choose to run your own server.