Set up a MariaDB SQL server. It supports multiple databases, users and permission settings. If you want to only connect from inside Home Assistant use core-mariadb as the host address.

  "databases": ["homeassistant"],
  "logins": [
      "username": "hass",
      "host": "homeassistant",
      "password": "securePassword"
  "rights": [
      "username": "hass",
      "host": "homeassistant",
      "database": "homeassistant",
      "grant": "ALL PRIVILEGES ON"

Configuration variables:

  • databases (Required): List of databases.
  • logins (Required): List of SQL accounts to create or update.
    • username (Required): Username for account.
    • host (Required): Host for account. If you need an account on multiple hosts, use ‘%’.
    • password (Required): Password for account.
  • rights (Required): List of rights to be granted.
    • username (Required): Username for granted rights.
    • host (Required): Host is a part of username like above.
    • database (Required): Database name on which to grant user rights.
    • grant (Required): SQL grant part for access too.

Home Assistant configuration

Use the following configuration in Home Assistant to use the database above:

  db_url: mysql://hass:securePassword@core-mariadb/homeassistant