Skip to content
Varco

Home Assistant quickstart

This path is for the Home Assistant owner.

Install

Section titled “Install”

  1. Copy custom_components/varco into your Home Assistant config directory:

    config/custom_components/varco

  2. Restart Home Assistant.

  3. Go to Settings -> Devices & services -> Add integration.

  4. Search for Varco and add it.

  5. Keep the default bridge URL unless you operate another bridge:

    wss://varco-bridge.andreabaccega.com

  6. Leave Enable WebRTC on unless you want relay-only transport. This Authority-side webrtc_enabled switch is distinct from the consumer-side connectionStrategy client option.

Only one Varco Authority can be configured in a Home Assistant instance. Varco can also be installed through HACS as a custom repository or configured via YAML; see Install Home Assistant.

Find the Authority ID

Section titled “Find the Authority ID”

Open the Varco sidebar panel or browse to:

/varco

Copy the Authority ID. Consumer apps need this public identifier to request access.

Approve a consumer

Section titled “Approve a consumer”
  1. Paste the Authority ID into the consumer app.
  2. The consumer sends an access request with its manifest.
  3. Home Assistant shows the pending request in the Varco panel.
  4. Compare the pairing code shown by the consumer with the code shown in Home Assistant.
  5. Review the requested permissions.
  6. Click Approve or Reject.

You can untick individual permissions in the request card before approving. The grant then contains only the selected subset of the requested manifest; the Authority never widens a request.

Manage grants

Section titled “Manage grants”

The Grants section of the Varco panel shows each grant’s status, including active, revoked, and expired grants. Use the search box and status filter when you have many consumers.

From each grant card you can:

  • Review activity — open the per-grant Activity section to see recent audit events for that grant. The panel shows event type, time, and safe metadata only; it does not show entity states, camera snapshots, or history payloads.
  • Revoke access — marks the grant revoked after an inline confirmation. Active sessions are marked closed and the consumer’s next message is rejected with grant_revoked; the consumer cannot re-authenticate.
  • Delete grant record — removes the grant permanently after an inline confirmation, including its audit history.
  • Manage restrictions — add, remove, enable/disable, or edit restrictions in place. Supported restriction types: expiry, schedule, PIN, rate-limit, and template. See Grants and scopes for details.

The panel header also shows relay health, including the bridge URL, last connected time, last error, and guidance when the relay is disconnected.

Dashboard export and build

Section titled “Dashboard export and build”

The panel can harvest a Lovelace dashboard or view into a selected entity manifest. Use Download agent brief zip to export brief.md and manifest.json for a coding agent, or Build share link to mint a read-only claim link that opens a Varco-rendered dashboard approximation grouped from the harvested Lovelace cards. The consumer still gets only Varco grant scopes, never a Home Assistant token.

Next

Section titled “Next”