mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-01 07:46:49 +00:00
![dependabot-preview[bot]](/assets/img/avatar_default.png)
Co-authored-by: dependabot-preview[bot] <27856297+dependabot-preview[bot]@users.noreply.github.com> Co-authored-by: Franck Nijhof <git@frenck.dev>
36 lines
927 B
Markdown
36 lines
927 B
Markdown
---
|
|
title: "keyring"
|
|
description: "Script to store secrets in a keyring"
|
|
---
|
|
|
|
Using [Keyring](https://github.com/jaraco/keyring) is an alternative way to `secrets.yaml`. The secrets can be managed from the command line via the `keyring` script.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```yaml
|
|
integration1:
|
|
api_key: !secret integration1_key
|
|
```
|
|
|
|
Create an entry in your keyring.
|
|
|
|
```bash
|
|
hass --script keyring set integration1_key
|
|
```
|
|
|
|
If you launch Home Assistant now, you will be prompted for the keyring password to unlock your keyring.
|
|
|
|
```bash
|
|
$ hass
|
|
Config directory: /home/homeassistant/.homeassistant
|
|
Please enter password for encrypted keyring:
|
|
```
|
|
|
|
<div class='note warning'>
|
|
If you are using the Python Keyring, automatic starting of Home Assistant Core will no longer work.
|
|
</div>
|