2019-03-10 04:45:59 -07:00

97 lines
2.1 KiB
Markdown

---
layout: page
title: "Linode"
description: "Instructions on how to set up Linode within Home Assistant."
date: 2017-10-20 08:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category:
- System Monitor
- Binary Sensor
- Switch
logo: linode.png
ha_release: 0.57
ha_iot_class: Cloud Polling
redirect_from:
- /components/binary_sensor.linode/
- /components/switch.linode/
---
The `linode` component allows you to access the information about your [Linode](https://linode.com) systems from Home Assistant.
There is currently support for the following device types within Home Assistant:
- [Binary Sensor](#binary-sensor)
- [Switch](#switch)
## {% linkable_title Setup %}
Obtain your oAuth2 Access Token from Linode account.
- <http://cloud.linode.com>
- Log in
- Select API Tokens
- Create a Personal Access Token,
- Assigned scope (Please choose the least possible access required.)
## {% linkable_title Configuration %}
To integrate Linode with Home Assistant, add the following section to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
linode:
access_token: YOUR_ACCESS_TOKEN
```
{% configuration %}
access_token:
description: The Linode access token.
required: true
type: string
{% endconfiguration %}
## {% linkable_title Binary Sensor %}
The `linode` binary sensor platform allows you to monitor your Linode nodes.
Add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
binary_sensor:
- platform: linode
nodes:
- 'myvpsname'
```
{% configuration %}
nodes:
description: List of VPSs you want to control.
required: true
type: string
{% endconfiguration %}
## {% linkable_title Switch %}
The `linode` switch platform allows you to turn your Linode nodes on and off.
Add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
switch:
- platform: linode
nodes:
- 'myvpsname'
```
{% configuration linode %}
nodes:
description: List of VPSs you want to control.
required: true
type: string
{% endconfiguration %}