Skip to content

Commit

Permalink
Add more details
Browse files Browse the repository at this point in the history
  • Loading branch information
fabaff committed Jul 14, 2016
1 parent 09c0b1c commit 74a3e83
Showing 1 changed file with 9 additions and 4 deletions.
13 changes: 9 additions & 4 deletions source/_components/recorder.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,16 @@ sharing: true
footer: true
logo: home-assistant.png
ha_category: "History"
featured: false
ha_release: "0.20"
ha_release: pre 0.7
---

The `recorder` component is storing details in the local database which then are handled by the [`history` component](/components/history/).
The `recorder` component is storing details in a database which then are handled by the [`history` component](/components/history/).

Home Assistant uses [SQLAlchemy](http://www.sqlalchemy.org/) as Object Relational Mapper (ORM). This means that you can now use **any** SQL backend for the recorder that is supported by SQLAlchemy, like [MySQL](https://www.mysql.com/), [MariaDB](https://mariadb.org/), or [PostgreSQL](https://www.postgresql.org/).

The default database engine is [SQLite](https://www.sqlite.org/) which doesn't require any configuration. The database is stored in your Home Assistant configuration directory (`.homeassistant`) and called `home-assistant.db`.

```bash

To setup the `recorder` component in your installation, add the following to your `configuration.yaml` file:

Expand All @@ -26,4 +31,4 @@ recorder:
Configuration variables:

- **purge_days** (*Optional*): Delete events and states older than x days.
- **db_url** (*Optional*): The URL which point to your database. Eg. `mysql://localhost/homeassistant`

0 comments on commit 74a3e83

Please sign in to comment.