Roraima Vendor Guide
Connect cloud accounts and gateways
Choose how to connect devices
For an Owner, the Technologies page is where each technology is connected once: the accounts of the device brands, Zigbee and Matter through the Roraima Hub, and Home Assistant. Individual devices are then added and managed only in Devices: see Manage devices. An Authorized Supplier sees the same page as Cloud Accounts, with the brand accounts only.
Connect the account a device needs, for example Shelly Cloud or the account of a smart-lock brand, before adding the device. MQTT devices do not need an account here.
Local gateways are not available at the moment; see the last section of this page.
Menu path
Owner: Vendor Back Office → Locks and devices → Technologies
An Authorized Supplier finds the brand accounts under Seller Tools, as Cloud Accounts.
The page opens with the sentence "Here you connect the brands and technologies of your devices just once. Individual devices are then added and managed in “Devices”." Below it, the page has four tabs side by side, Manufacturers, Zigbee, Matter and Home Assistant; one tab is shown at a time. Opening the page from the menu shows Manufacturers. A link from another page, or from the Roraima integration in Home Assistant, opens the matching tab directly, even when you have to sign in first. The Owner's page has no filters.
An Authorized Supplier first selects the customer in the supplier dashboard. Some customer connection areas may be view-only when the supplier is not permitted to change them.
Find and manage a cloud account
The Manufacturers tab (for an Authorized Supplier, the whole Cloud Accounts page) lists the brand accounts with Provider, Cloud server address, Status, Last updated and Actions. An Authorized Supplier can also narrow the list with two filters and select Search; the page reloads with the selected provider and status. The Owner's tab has no filters.
| Label | Purpose | Instruction | Requirement or condition |
|---|---|---|---|
| Provider | Limits the account list | Leave All selected or choose Shelly Cloud, Tuya Smart Life, Tedee Smart Lock, Nuki Smart Lock, iGloohome Smart Lock or TTLock | Optional; Authorized Supplier only |
| Status | Limits results by account status | Leave All selected or choose Active or Disabled | Optional; Authorized Supplier only |
Use Edit to replace or review provider details, Test to check the provider connection, and Delete only when devices that depend on the account may stop working. TTLock also provides Connect again, which reopens the TTLock connection window for the same account, for example when TTLock no longer accepts the saved sign-in, and Import devices.
Add a cloud account
Select Add cloud account and choose an available provider. A provider already connected does not appear as another add choice; edit the existing account instead.
| Provider | Details requested | Instruction | Condition |
|---|---|---|---|
| Shelly Cloud | Cloud Server URL and Authorization key | Copy the values from the Shelly cloud-authorisation area | Both are required when first connecting the account |
| Tuya Smart Life | Smart Life UID | Copy the UID from the linked Smart Life account in the Tuya platform | Required; use the full UID rather than an app display code |
| Tedee Smart Lock | Provider access credential | Use the credential created for the account that owns the locks | Provider form only |
| Nuki Smart Lock | Nuki account authorisation | Select Connect Nuki, sign in with your Nuki Web account on the Nuki website and authorise Roraima to use your locks. You then return to this page with the account connected | No credential to copy |
| iGloohome Smart Lock | Provider-specific connection details | Complete the fields shown in the iGloohome form | Provider form only |
| TTLock | TTLock account connection | Use the dedicated TTLock connection window described below | Does not use the standard provider form |
Stored passwords and secret values are not shown again. When editing an account, leave a secret field empty to keep its current value and enter a new value only when replacing it.
A Tuya Smart Life account can still be connected and managed from this page, and any device that already uses it keeps working normally. Tuya is not currently offered as a connection method when adding a new device; see Manage devices for the connection methods available today.
TTLock connection and import
| Label | Purpose | Instruction | Requirement or condition |
|---|---|---|---|
| TTLock username / email | Identifies the TTLock app account | Enter the login used by the TTLock mobile app | Required in the TTLock connection window |
| TTLock password | Authorises the TTLock connection | Enter the current app password | Required; not displayed after connection |
| Mode | Chooses the TTLock account mode | Keep the recommended shared mode unless your business uses its own developer account | Required |
After connecting TTLock, select Import devices and add the locks you need from the list. Every item added this way is created as a key safe with limited controls; the TTLock list does not distinguish a key safe from a remotely operated smart lock. If the imported item is a smart lock rather than a key safe, contact Roraima support to correct its type — it cannot be changed from this window or from the device page. Return to Manage devices to confirm the imported device.
Zigbee and Matter of the Roraima Hub
The Zigbee and Matter tabs show one status box for each Roraima Hub of the Owner, named after its property. They are shown to the Owner who can open the Roraima Hub page, including an Owner who only has their own Hub; an Authorized Supplier working for a customer does not see them. The boxes do not list devices and do not add them: Zigbee and Matter devices are added from Devices → Add device, with the Zigbee and Matter cards, and are listed only in Devices (see Manage devices).
| Tab | What it shows | What you can do | Condition |
|---|---|---|---|
| Zigbee | The state of the Zigbee network, for example Zigbee active, the family of the USB Zigbee stick and the last contact | Follow the advice under the state, for example connect a Zigbee stick to the Hub. A notice appears for 30 days after a stick of a different family is connected, because devices may need pairing again | One box per Roraima Hub with Zigbee |
| Matter | The state of Matter on the Hub, for example Matter not active yet, Matter active or Matter needs to be restored, and the last contact | Activate Matter the first time; afterwards add devices from the Matter card of Add device. Start over with Matter appears only when Matter needs to be restored, and only to the main administrator of the account, with a second confirmation; it cannot be undone | One box per Roraima Hub where Matter is present |
Without a Roraima Hub, each of the two tabs shows "To connect Zigbee devices you need the Roraima Hub, which you can buy and activate from its page." (or Matter devices) with a link to the Roraima Hub page, where the Hub is bought and activated. The Roraima Hub page keeps purchase, activation and replacements, and shows one summary line for each Hub, such as "Zigbee active — Technologies", that opens the matching tab of this page.
Matter works with plugs and devices certified for Matter that use the property's Wi-Fi, on the same network as the Roraima Hub.
Home Assistant
The last tab, Home Assistant, lets the Owner connect a Home Assistant installation with the Roraima integration. Only the Owner sees it. From top to bottom it has:
- Create pairing code, with the sentence "Press the button to create the pairing code, then paste it into the Roraima integration window in Home Assistant." Once pressed, the button is replaced by Your pairing code, with the code and a Copy button; the code is shown only this once. No name is needed: the first connection is called "Home Assistant", the next ones "Home Assistant 2", "Home Assistant 3" and so on.
- The list of connections, with Name, Status (Connected or Not connected), Last contact, Shared devices and Disconnect.
- What the connection is for, the monthly fee of each shared device, and Add to Home Assistant, which installs the Roraima integration in your Home Assistant if you do not have it yet.
The devices chosen in Home Assistant then appear on their own in Devices. The connection is free of charge, while each shared device has its own monthly fee until it is deleted. See Manage devices for the details.
Local gateways are not available
Local gateways cannot be registered at the moment. The Local Gateways menu entry and the Add gateway button are no longer shown, and opening the registration page directly returns to the gateway list without creating anything. To connect a device, use a manufacturer account, one of the other connection methods described in Manage devices, or the Owner's Roraima Hub for Zigbee sensors and plugs and for Matter devices that use the property's Wi-Fi.
A local gateway registered earlier stays in the gateway list. The Owner reaches it from the first page of the Vendor Back Office: in the Locks and devices box, select the gateway marked Offline. The list shows Gateway name, Status, Last contact, Created on and Actions. A gateway in this list stays Offline and does not control any device.
| Label | Purpose | Instruction | Requirement or condition |
|---|---|---|---|
| Search | Finds a registered gateway | Enter part of the gateway name or its ID, then select Search | Optional; the result list reloads and keeps the search across pages |
Delete removes a gateway after a confirmation, and the devices that used it fall back to their cloud connection. It cannot be undone: a deleted gateway cannot be registered again while local gateways are unavailable. An Authorized Supplier working for a customer cannot delete the customer's gateways.
Local gateways pay no monthly price while they are unavailable, but they still count towards the maximum number of devices and local gateways of the business.
Related guidance
Return to Manage devices to add or test the device after its connection is ready. Authorized Suppliers should also read Work for a customer before changing a customer's setup.
Matter™ and Zigbee are trademarks of the Connectivity Standards Alliance. Other trademarks mentioned belong to their respective owners.