home-assistant.io/source/_components/vultr.markdown

layout, title, description, date, sidebar, comments, sharing, footer, ha_category, ha_release, logo, ha_iot_class, redirect_from

layout	title	description	date	sidebar	comments	sharing	footer	ha_category	ha_release	logo	ha_iot_class	redirect_from
page	Vultr	Instructions on how to integrate Vultr within Home Assistant.	2017-10-17 21:00	true	false	true	true	System Monitor Binary Sensor Sensor Switch	0.58	vultr.png	Cloud Polling	/components/binary_sensor.vultr/ /components/sensor.vultr/ /components/switch.vultr/

The vultr component allows you to access information about and interact with your Vultr subscriptions (Virtual Private Servers) from Home Assistant.

There is currently support for the following device types within Home Assistant:

• Binary Sensor
• Sensor
• Switch

{% linkable_title Configuration %}

Obtain your API key from your Vultr Account.

Ensure you allow the public IP of Home Assistant under the Access Control heading.

To integrate your Vultr subscriptions with Home Assistant, add the following section to your configuration.yaml file:

# Example configuration.yaml entry
vultr:
  api_key: YOUR_API_KEY

{% configuration %} api_key: description: Your Vultr API key. required: true type: string {% endconfiguration %}

{% linkable_title Binary sensor %}

The vultr binary sensor platform allows you to monitor your Vultr subscription to see if it is powered on or not.

{% linkable_title Configuration %}

To use this binary sensor, you first have to set up your Vultr hub.

The following examples assume a subscription that has an ID of `123456` and a label of `Web Server`

Minimal configuration.yaml (produces binary_sensor.vultr_web_server):

# Example configuration.yaml entry
binary_sensor:
  - platform: vultr
    subscription: 123456

{% configuration %} subscription: description: The subscription you want to monitor, this can be found in the URL when viewing a server. required: true type: string name: description: The name you want to give this binary sensor. required: false default: "Vultr {subscription label}" type: string {% endconfiguration %}

{% linkable_title Full example %}

Full configuration.yaml (produces binary_sensor.totally_awesome_server):

binary_sensor:
  - platform: vultr
    name: totally_awesome_server
    subscription: 12345

{% linkable_title Sensor %}

The vultr sensor platform will allow you to view current bandwidth usage and pending charges against your Vultr subscription.

To use this sensor, you must set up your Vultr hub.

The following examples assume a subscription that has an ID of `123456` and a label of `Web Server`

Minimal configuration.yaml (produces sensor.vultr_web_server_current_bandwidth_used and sensor.vultr_web_server_pending_charges):

sensor:
  - platform: vultr
    subscription: 123456

{% configuration %} subscription: description: The Vultr subscription to monitor, this can be found in the URL when viewing a subscription. required: true type: string name: description: The name to give this sensor. required: false default: "Vultr {Vultr subscription label} {monitored condition name}" type: string monitored_conditions: description: List of items you want to monitor for each subscription. required: false detault: All conditions type: list keys: current_bandwidth_used: description: The current (invoice period) bandwidth usage in Gigabytes (GB). temperature: pending_charges: The current (invoice period) charges that have built up for this subscription. Value is in US Dollars (US$). {% endconfiguration %}

Full configuration.yaml using {} to format condition name (produces sensor.server_current_bandwidth_used and sensor.server_pending_charges):

sensor:
  - platform: vultr
    name: Server {}
    subscription: 123456
    monitored_conditions:
      - current_bandwidth_used
      - pending_charges

Custom configuration.yaml with only one condition monitored (produces sensor.web_server_bandwidth):

sensor:
  - platform: vultr
    name: Web Server Bandwidth
    subscription: 123456
    monitored_conditions:
      - current_bandwidth_used

{% linkable_title Switch %}

The vultr switch platform allows you to control (start/stop) your Vultr subscription.

To control your Vultr subscription, you first have to set up your Vultr hub.

{% linkable_title Configuration %}

Minimal configuration.yaml (produces switch.vultr_web_server):

# Example configuration.yaml entry
switch:
  - platform: vultr
    subscription: YOUR_SUBSCRIPTION_ID

{% configuration %} subscription: description: List of droplets you want to control. required: true type: string name: description: The name you want to give this switch. required: false default: "Vultr {subscription label}" type: string {% endconfiguration %}

{% linkable_title Additional Examples %}

Full example that produces switch.amazing_server, assuming a subscription that has an ID of 123456 and a label of Web Server:

# Example configuration.yaml entry
switch:
  - platform: vultr
    name: Amazing Server
    subscription: 123456