mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-09 04:29:03 +00:00
92 lines
1.9 KiB
Markdown
92 lines
1.9 KiB
Markdown
---
|
|
title: Linode
|
|
description: Instructions on how to set up Linode within Home Assistant.
|
|
ha_category:
|
|
- Binary Sensor
|
|
- Switch
|
|
- System Monitor
|
|
ha_release: 0.57
|
|
ha_iot_class: Cloud Polling
|
|
ha_domain: linode
|
|
ha_platforms:
|
|
- binary_sensor
|
|
- switch
|
|
ha_integration_type: integration
|
|
---
|
|
|
|
The `linode` integration 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)
|
|
|
|
## Setup
|
|
|
|
Obtain your oAuth2 Access Token from Linode account.
|
|
|
|
- <https://cloud.linode.com>
|
|
- Log in
|
|
- Select API Tokens
|
|
- Create a Personal Access Token,
|
|
- Assigned scope (Please choose the least possible access required.)
|
|
|
|
## 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 %}
|
|
|
|
## 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 %}
|
|
|
|
## 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 %}
|