From 74a3e8342ed83eb7f6ca4084a5ce10306128c3c8 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 14 Jul 2016 17:58:45 +0200 Subject: [PATCH] Add more details --- source/_components/recorder.markdown | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/source/_components/recorder.markdown b/source/_components/recorder.markdown index bbac2f7061f..08274023247 100644 --- a/source/_components/recorder.markdown +++ b/source/_components/recorder.markdown @@ -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: @@ -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`