---
layout: page
title: "Rachio Switch"
description: "Instructions how to use Rachio switches with Home Assistant."
date: 2017-05-29 09:00
sidebar: true
comments: false
sharing: true
footer: true
logo: rachio.png
ha_category: Switch
ha_iot_class: "Local Polling"
ha_release: 0.46
---

The `rachio` switch platform allows you to control your [Rachio irrigations system](http://rachio.com/).

## {% linkable_title Getting your Rachio API Access Token %}

- Log in at [https://app.rach.io/](https://app.rach.io/).
- Click the user button at the top right.
- Click API Access Token.
- Copy the API access token from the dialog that opens.

To add this platform to your installation, add the following to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
switch:
  - platform: rachio
    access_token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```

Configuration variables:

- **access_token** (*Required3): Your Rachio API Access Token.
- **manual_run_mins** (*Optional*): For how long, in minutes, to turn on a station when the switch is enabled. Defaults to 10 minutes.

## {% linkable_title Examples %}

In this section you find some real life examples of how to use this switch.

### {% linkable_title `groups.yaml` example %}


```yaml
irrigation:
  name: Irrigation
  icon: mdi:water-pump
  view: true
  entities:
  - group.zones_front
  - group.zones_back

zones_front:
  name: Front Yard
  view: false
  entities:
  - switch.driveway
  - switch.front_bushes
  - switch.front_garden
  - switch.front_yard
  - switch.side_yard

zones_back:
  name: Back Yard
  view: false
  entities:
  - switch.back_bushes
  - switch.back_garden
  - switch.back_porch
  - switch.back_trees
```

### {% linkable_title iFrame %}

If you would like to see the Rachio details then create an [iFrame](/components/panel_iframe/) that contains the information accessible through your panel.

```yaml
panel_iframe:
  rachio:
    title: Rachio
    url: "https://app.rach.io"
    icon: mdi:water-pump
```