---
layout: page
title: "Linux Battery"
description: "Instructions on how to integrate Linux Battery information into Home Assistant."
date: 2016-09-06 07:00
sidebar: true
comments: false
sharing: true
footer: true
logo: linux_battery.png
ha_category: System Monitor
ha_release: 0.28
ha_iot_class: "Local Polling"
---

The `linux_battery` sensor platform is using the information stored in `/sys/class/power_supply/` on your local Linux system to display details about the current state of your battery.

To setup a battery sensor to your installation, add the following to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
sensor:
  - platform: linux_battery
```

{% configuration %}
name:
  description: Friendly name to use for the frontend.
  required: false
  default: Battery
  type: string
battery:
  description: Number of the battery.
  required: false
  default: 1
  type: integer
system:
  description: "The local system type. Support `linux` and `android`."
  required: false
  default: linux
  type: string  
{% endconfiguration %}
