---
title: Supervisor
description: Control Supervisor Add-ons and OS from Home Assistant
ha_category:
  - Binary Sensor
  - Sensor
ha_iot_class: Local Polling
ha_release: 0.42
ha_domain: hassio
ha_platforms:
  - binary_sensor
  - sensor
---

Supervisor integration allows you to monitor and control Supervisor add-ons and operating system from Home Assistant.
This integration is installed automatically if you run Home Assistant OS or Supervised.

## Sensors

For each installed add-on Supervisor provides following sensors:

| Sensor | Enabled by default | Description |
| ------- | ------------------ | ----------- |
| Version | no | Current version of the add-on
| Newest Version | no | Latest version of the add-on currently available
| CPU Percent| no | The CPU Percent usage of the add-on
| Memory Percent| no | The Memory (RAM) Percent usage of the add-on

For Home Assistant OS Supervisor provides following sensors:

| Sensor | Enabled by default | Description |
| ------- | ------------------ | ----------- |
| Version | no | Current version of the Home Assistant OS
| Newest Version | no | Latest version of the Home Assistant OS currently available

## Binary Sensors

For each installed add-on Supervisor provides following binary sensors:

| Sensor | Enabled by default | Description |
| ------- | ------------------ | ----------- |
| Update Available | no | Whether there is an update available for this add-on
| Running | no | Whether the add-on is running or not.

For Home Assistant OS Supervisor provides following binary sensors:

| Sensor | Enabled by default | Description |
| ------- | ------------------ | ----------- |
| Update Available | no | Whether there is an update available for OS

## Services

### Service hassio.addon_start

Start an add-on.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `addon` | no | Add-on slug

### Service hassio.addon_stop

Stop an add-on.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `addon` | no | Add-on slug

### Service hassio.addon_restart

Restart an add-on.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `addon` | no | Add-on slug

### Service hassio.addon_stdin

Write data to add-on stdin.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `addon` | no | Add-on slug

### Service hassio.addon_update

Update add-on. This service should be used with caution since add-on updates can contain breaking changes. It is highly recommended that you review release notes/change logs before updating an add-on.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `addon` | no | Add-on slug

### Service hassio.host_reboot

Reboot the host system.

### Service hassio.host_shutdown

Shutdown the host system.

### Service hassio.backup_full

Create a full backup.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `name` | yes | Name of the backup file. Default is current date and time
| `password` | yes | Optional password for backup

### Service hassio.backup_partial

Create a partial backup.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `addons` | yes | List of add-on slugs to backup
| `folders` | yes | List of directories to backup
| `name` | yes | Name of the backup file. Default is current date and time
| `password` | yes | Optional password for backup

### Service hassio.restore_full

Restore from full backup.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `slug` | no | Slug of backup to restore from
| `password` | yes | Optional password for backup

### Service hassio.restore_partial

Restore from partial backup.

| Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `slug` | no | Slug of backup to restore from
| `homeassistant` | yes | Whether to restore Home Assistant, `true` or `false`
| `addons` | yes | List of add-on slugs to restore
| `folders` | yes | List of directories to restore
| `password` | yes | Optional password for backup