diff --git a/atom.xml b/atom.xml index 1e87d7754f..019740e7e6 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/announcements/atom.xml b/blog/categories/announcements/atom.xml index 00f8fa5acc..03288a6761 100644 --- a/blog/categories/announcements/atom.xml +++ b/blog/categories/announcements/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Announcements | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index f1a1b1b477..f466473e05 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index b5ae9bbf16..fdf9e3b125 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 33df8e15b5..d7a6ce5145 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index ffeb71b6c2..d36dca2461 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 921df961d8..0558759bdf 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index 07fd47134b..422f08941b 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index e67fadfb69..ec0b83ec0f 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/media/atom.xml b/blog/categories/media/atom.xml index 761e2a10a2..adf7b6a758 100644 --- a/blog/categories/media/atom.xml +++ b/blog/categories/media/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Media | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/merchandise/atom.xml b/blog/categories/merchandise/atom.xml index 843dfa20c3..50b1544d62 100644 --- a/blog/categories/merchandise/atom.xml +++ b/blog/categories/merchandise/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Merchandise | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index e3844d0fc2..8ac68accea 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index e65897a41c..4398854718 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/organization/atom.xml b/blog/categories/organization/atom.xml index c84b619672..fd2424fcc2 100644 --- a/blog/categories/organization/atom.xml +++ b/blog/categories/organization/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organization | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 40703e0b7e..6914914760 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 29384475a7..025aef7c09 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index 3b98da71ba..33b5d4f134 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 467758f170..3b253be393 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index 553044bc1b..0d711e535e 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 589e74dbbf..769769c4c7 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 258aeb8576..04d7891860 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 96b9cc78b0..fe82ed1854 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index c055b84454..293a126ac9 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index d700268b3a..fa9d9fe574 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2018-01-31T07:23:27+00:00 + 2018-01-31T08:44:19+00:00 https://home-assistant.io/ diff --git a/components/influxdb/#data-import-script.html b/components/influxdb/#data-import-script.html new file mode 100644 index 0000000000..a3fda9b492 --- /dev/null +++ b/components/influxdb/#data-import-script.html @@ -0,0 +1,10 @@ + + + + Redirecting… + + +

Redirecting…

+ Click here if you are not redirected. + + diff --git a/components/influxdb/#data-migration.html b/components/influxdb/#data-migration.html new file mode 100644 index 0000000000..f5251a9c0d --- /dev/null +++ b/components/influxdb/#data-migration.html @@ -0,0 +1,10 @@ + + + + Redirecting… + + +

Redirecting…

+ Click here if you are not redirected. + + diff --git a/components/influxdb/index.html b/components/influxdb/index.html index 0cc12ab5f1..872062fad7 100644 --- a/components/influxdb/index.html +++ b/components/influxdb/index.html @@ -115,108 +115,11 @@
  • tags (Optional): Tags to mark the data.
  • tags_attributes (Optional): The list of attribute names which should be reported as tags and not fields to InfluxDB. For example, if set to friendly_name, it will be possible to group by entities’ friendly names as well, in addition to their ids.
  • -

    Data migration

    -

    Starting with 0.36 the InfluxDB component has a new schema to store values in the InfluxDB databases.

    +

    Helper scripts

      -
    • There will no longer be any tags/fields named time.
    • -
    • All numeric fields (int/float/bool) will be stored as float inside InfluxDB database.
    • -
    • All string fields corresponding to state attributes will be renamed as FIELDNAME_str, where FIELDNAME is the state attribute, to avoid type conflicts.
    • -
    • All string fields corresponding to a state will be renamed as state (former value).
    • -
    • Fields named value will always be stored as float.
    • -
    • Fields named state will always be stored as string.
    • +
    • Helper script influxdb_import
    • +
    • Helper script db_migrator (only used for Home Assistant 0.36)
    -

    Migration script

    -

    If you need to migrate your database, you may require to run the influxdb_migrator script. Run the script after upgrade to 0.36 but before the first regular start of hass version 0.36.

    -

    These are the steps the script will perform:

    -
      -
    1. Create a new database (called DBNAME__old) to store old data.
    2. -
    3. Copy data from DBNAME database to DBNAME__old database.
    4. -
    5. Empty DBNAME database (using drop then create). DBNAME database is now considered as the new database.
    6. -
    7. For each measurement of DBNAME__old database:
    8. -
    9. Read all points from the current measurement (in groups of 1000 points by default) and convert them.
    10. -
    11. Send group of points to DBNAME database.
    12. -
    13. Delete the DBNAME__old database if needed.
    14. -
    -

    Example to run the script:

    -
    $ hass --script influxdb_migrator \
    -    -H IP_INFLUXDB_HOST -u INFLUXDB_USERNAME -p INFLUXDB_PASSWORD \
    -    -d INFLUXDB_DB_NAME
    -
    -
    -

    Script arguments:

    -
    required arguments:
    -  -d dbname, --dbname dbname  InfluxDB database name
    -
    -optional arguments:
    -  -h, --help            show this help message and exit
    -  -H host, --host host  InfluxDB host address
    -  -P port, --port port  InfluxDB host port
    -  -u username, --username username
    -                        InfluxDB username
    -  -p password, --password password
    -                        InfluxDB password
    -  -s step, --step step  How many points to migrate at the same time
    -  -o override_measurement, --override-measurement override_measurement
    -                        Store all your points in the same measurement
    -  -D, --delete          Delete old database
    -
    -
    -
      -
    • If you run the script with only the -h option, you will get a help printout with a short explanation of the different options.
    • -
    • The host option defaults to '127.0.0.1'.
    • -
    • The port option defaults to 8086.
    • -
    • You should be able to omit username and password if InfluxDB authentication is disabled, which it is by default.
    • -
    • The step option defaults to 1000.
    • -
    -

    Data import script

    -

    If you want to import all the recorded data from your recorder database you can use the data import script. -It will read all your state_change events from the database and add them as data-points to the InfluxDB. -You can specify the source database either by pointing the --config option to the config directory which includes the default SQLite database or by giving a sqlalchemy connection URI with --uri. -The writing to InfluxDB is done in batches that can be changed with --step.

    -

    You can control, which data is imported by using the command line options --exclude_entities and --exclude_domains. -Both get a comma separated list of either entity-ids or domain names that are excluded from the import.

    -

    To test what gets imported you can use the --simulate option, which disables the actual write to the InfluxDB instance. -This only writes the statistics how much points would be imported from which entity.

    -

    Example to run the script:

    -
    $ hass --script influxdb_import --config CONFIG_DIR \
    -    -H IP_INFLUXDB_HOST -u INFLUXDB_USERNAME -p INFLUXDB_PASSWORD \
    -    --dbname INFLUXDB_DB_NAME --exclude_domains automation,configurator
    -
    -
    -

    Script arguments:

    -
    required arguments:
    -  -d dbname, --dbname dbname
    -                        InfluxDB database name
    -
    -optional arguments:
    -  -h, --help            show this help message and exit
    -  -c path_to_config_dir, --config path_to_config_dir
    -                        Directory that contains the Home Assistant
    -                        configuration
    -  --uri URI             Connect to URI and import (if other than default
    -                        sqlite) eg: mysql://localhost/homeassistant
    -
    -  -H host, --host host  InfluxDB host address
    -  -P port, --port port  InfluxDB host port
    -  -u username, --username username
    -                        InfluxDB username
    -  -p password, --password password
    -                        InfluxDB password
    -  -s step, --step step  How many points to import at the same time
    -  -t tags, --tags tags  Comma separated list of tags (key:value) for all
    -                        points
    -  -D default_measurement, --default-measurement default_measurement
    -                        Store all your points in the same measurement
    -  -o override_measurement, --override-measurement override_measurement
    -                        Store all your points in the same measurement
    -  -e exclude_entities, --exclude_entities exclude_entities
    -                        Comma separated list of excluded entities
    -  -E exclude_domains, --exclude_domains exclude_domains
    -                        Comma separated list of excluded domains
    -  -S, --simulate        Do not write points but simulate preprocessing
    -                        and print statistics
    -
    -

    Examples

    Full configuration

    influxdb:
    diff --git a/docs/asterisk_mbox/index.html b/docs/asterisk_mbox/index.html
    index e3da5d72a4..af01ae6a24 100644
    --- a/docs/asterisk_mbox/index.html
    +++ b/docs/asterisk_mbox/index.html
    @@ -257,7 +257,13 @@ This assumes that your Asterisk PBX server is using () {
             
           
           
  • diff --git a/docs/autostart/macos/index.html b/docs/autostart/macos/index.html index 5d27556811..6e92db6749 100644 --- a/docs/autostart/macos/index.html +++ b/docs/autostart/macos/index.html @@ -182,7 +182,13 @@ Home Assistant has been uninstalled.
  • diff --git a/docs/autostart/synology/index.html b/docs/autostart/synology/index.html index 1d4b26d19d..ccaaadc9ac 100644 --- a/docs/autostart/synology/index.html +++ b/docs/autostart/synology/index.html @@ -197,7 +197,13 @@ stop on runlevel [06]
  • diff --git a/docs/autostart/systemd/index.html b/docs/autostart/systemd/index.html index 498327eeb1..051fcf5369 100644 --- a/docs/autostart/systemd/index.html +++ b/docs/autostart/systemd/index.html @@ -267,7 +267,13 @@ WantedBy=multi-user.target
  • diff --git a/docs/autostart/upstart/index.html b/docs/autostart/upstart/index.html index de2e6642a7..8b8b7d9185 100644 --- a/docs/autostart/upstart/index.html +++ b/docs/autostart/upstart/index.html @@ -286,7 +286,13 @@ esac
  • diff --git a/docs/backend/database/index.html b/docs/backend/database/index.html index 03b0f5b0de..cf4edcbdc6 100644 --- a/docs/backend/database/index.html +++ b/docs/backend/database/index.html @@ -262,7 +262,13 @@ group.all_switches 8018
  • diff --git a/docs/backend/index.html b/docs/backend/index.html index ad6027780e..56e0c0af76 100644 --- a/docs/backend/index.html +++ b/docs/backend/index.html @@ -171,7 +171,13 @@
  • diff --git a/docs/backend/updater/index.html b/docs/backend/updater/index.html index 59eac54fa4..6af59761f5 100644 --- a/docs/backend/updater/index.html +++ b/docs/backend/updater/index.html @@ -333,7 +333,13 @@
  • diff --git a/docs/configuration/basic/index.html b/docs/configuration/basic/index.html index f715a4f353..ef1b050aba 100644 --- a/docs/configuration/basic/index.html +++ b/docs/configuration/basic/index.html @@ -201,7 +201,13 @@ If you decide to expose your Home Assistant instance to the internet and forget
  • diff --git a/docs/configuration/customizing-devices/index.html b/docs/configuration/customizing-devices/index.html index 90a9594c20..8393366077 100644 --- a/docs/configuration/customizing-devices/index.html +++ b/docs/configuration/customizing-devices/index.html @@ -274,7 +274,13 @@ New customize information will be applied the next time the state of the entity
  • diff --git a/docs/configuration/devices/index.html b/docs/configuration/devices/index.html index fa035215ae..4c86c6f555 100644 --- a/docs/configuration/devices/index.html +++ b/docs/configuration/devices/index.html @@ -216,7 +216,13 @@ Each group consists of a name and a list of entity IDs. Entity IDs can be retrie
  • diff --git a/docs/configuration/events/index.html b/docs/configuration/events/index.html index 0d0c5054e4..085b7f9896 100644 --- a/docs/configuration/events/index.html +++ b/docs/configuration/events/index.html @@ -314,7 +314,13 @@
  • diff --git a/docs/configuration/group_visibility/index.html b/docs/configuration/group_visibility/index.html index edf2af7404..53fc408544 100644 --- a/docs/configuration/group_visibility/index.html +++ b/docs/configuration/group_visibility/index.html @@ -319,7 +319,13 @@ If you are using docker to run Home Assistant then the occasion.py script will b
  • diff --git a/docs/configuration/index.html b/docs/configuration/index.html index a087ca606c..094c77ba81 100644 --- a/docs/configuration/index.html +++ b/docs/configuration/index.html @@ -201,7 +201,13 @@
  • diff --git a/docs/configuration/packages/index.html b/docs/configuration/packages/index.html index de0b772935..0837a5f477 100644 --- a/docs/configuration/packages/index.html +++ b/docs/configuration/packages/index.html @@ -233,7 +233,13 @@ See the documentation about + + Redirecting… + + +

    Redirecting…

    +
    Click here if you are not redirected. + + diff --git a/docs/configuration/secrets/#storing-passwords-securely-in-aws.html b/docs/configuration/secrets/#storing-passwords-securely-in-aws.html new file mode 100644 index 0000000000..58ee780fec --- /dev/null +++ b/docs/configuration/secrets/#storing-passwords-securely-in-aws.html @@ -0,0 +1,10 @@ + + + + Redirecting… + + +

    Redirecting…

    + Click here if you are not redirected. + + diff --git a/docs/configuration/secrets/index.html b/docs/configuration/secrets/index.html index 582174141f..9e44d53423 100644 --- a/docs/configuration/secrets/index.html +++ b/docs/configuration/secrets/index.html @@ -105,49 +105,16 @@
  • This will not print the actual secret’s value to the log.

    -

    Option 2: View where secrets are retrieved from and the contents of all secrets.yaml files used, you can use the check_config script from the command line:

    +

    Option 2: View where secrets are retrieved from and the contents of all secrets.yaml files used, you can use the check_config script from the command line:

    $ hass --script check_config --secrets
     

    This will print all your secrets.

    -

    Storing passwords in a keyring managed by your OS

    -

    Using Keyring is an alternative way to secrets.yaml. They can be managed from the command line via the keyring script.

    -
    $ hass --script keyring --help
    -
    -
    -

    To store a password in keyring, replace your password or API key with !secret and an identifier in configuration.yaml file.

    -
    http:
    -  api_password: !secret http_password
    -
    -
    -

    Create an entry in your keyring.

    -
    $ hass --script keyring set http_password
    -
    -
    -

    If you launch Home Assistant now, you will be prompted for the keyring password to unlock your keyring.

    -
    $ hass
    -Config directory: /home/homeassistant/.homeassistant
    -Please enter password for encrypted keyring:
    -
    -
    -

    - If you are using the Python Keyring, autostarting of Home Assistant will no longer work. -

    -

    Storing passwords securely in AWS

    -

    Using Credstash is an alternative way to secrets.yaml. They can be managed from the command line via the credstash script.

    -

    Before using credstash, you need to set up AWS credentials either via the aws command line tool or using environment variables as explained in the AWS CLI docs as well as creating a KMS key named credstash as explained in the credstash Readme. After that is complete, you can use the provided script to add secrets to your Home Assistant secret store in credstash.

    -
    $ hass --script credstash --help
    -
    -
    -

    To store a password in credstash, replace your password or API key with !secret and an identifier in configuration.yaml file.

    -
    http:
    -  api_password: !secret http_password
    -
    -
    -

    Create an entry in your credstash store.

    -
    $ hass --script credstash set http_password
    -
    -
    +

    Alternatives to secrets.yaml

    +