The command-line and the frontend which simplify common tasks, are helping with migrations, and ensure that Home Assistant runs properly. Please do not confuse those with Home Assistant’s script feature.

Configuration check

Test any changes to your configuration.yaml file before launching Home Assistant. This script allows you to test changes without the need to restart Home Assistant.

$ hass --script check_config

Existence of configuration

This script checks if the configuration.yaml file exists. If the file is not available, one is created.

$ hass --script ensure_config


There is a method to store secrets outside of your configuration.yaml file. For further details, please refer to the Storing Secrets documentation.

$ hass --script keyring


For testing the performance of Home Assistant the Benchmark script runs until you exit using Control+C.

Firing and handling of a million events.

$ hass --script benchmark async_million_events

Old scripts

Usually those scripts were only used when a massive update happened and was announced in the release notes.

  • db_migrator: Migrate an existing SQLite database to the new schema.
  • influxdb_migrator: Convert an old InfluxDB to the new format.