keyring.markdown

layout	title	description	release_date	sidebar	comments	sharing	footer
page	keyring	Script to store secrets in a keyring	2017-02-23 03:00:00 -0800	true	false	true	true

Using Keyring is an alternative way to secrets.yaml. The secrets 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](/getting-started/autostart/) of Home Assistant will no longer work.