---
layout: page
title: "Orvibo Switch"
description: "Instructions on how to integrate Orvibo sockets within Home Assistant."
date: 2015-11-15 18:15
sidebar: true
comments: false
sharing: true
footer: true
logo: orvibo.png
ha_category: Switch
---

The `orvibo` switch platform allows you to toggle your Orvibo S20 Wifi Smart Sockets.

To automatically discover Orvibo sockets on your network:

```yaml
# Example configuration.yaml entry
switch:
  - platform: orvibo
```

To specify Orvibo sockets and skip discovery:

```yaml
# Example configuration.yaml entry
switch:
  - platform: orvibo
    discovery: false
    switches:
      - host: IP_ADDRESS
        mac: MA:CA:DD:RE:SS:00
        name: "My Socket"
```

{% configuration %}
discovery:
  description: Whether to discover sockets.
  required: false
  default: true
  type: boolean
switches:
  description: A list of Orvibo switches.
  required: false
  type: list
  keys:
    host:
      description: "IP address of your socket, e.g., 192.168.1.10."
      required: true
      type: string
    mac:
      description: "MAC address of the socket, e.g., `AA:BB:CC:DD:EE:FF`. This is required if the socket is connected to a different subnet to the machine running Home Assistant."
      required: false
      type: string
    name:
      description: Your name for the socket.
      required: false
      default: Orvibo S20 Switch
      type: string
{% endconfiguration %}
