mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-27 12:36:50 +00:00
5de7beef7c
Explanation for the two new fields `deployment_key` and `deployment_key_protocol`. See PR home-assistant/hassio-addons#196
48 lines
1.7 KiB
Markdown
48 lines
1.7 KiB
Markdown
---
|
|
layout: page
|
|
title: "GIT pull"
|
|
description: "Load and update configuration files for Home Assistant from a GIT repository."
|
|
date: 2017-09-25 14:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
---
|
|
|
|
Load and update configuration files for Home Assistant from a GIT repository.
|
|
|
|
```json
|
|
{
|
|
"repository": "https://example.com/my_configs",
|
|
"auto_restart": false,
|
|
"repeat": {
|
|
"active": false,
|
|
"interval": 300
|
|
},
|
|
"deployment_key": [
|
|
"-----BEGIN RSA PRIVATE KEY-----",
|
|
"MIIEowIBAAKCAQEAv3hUrCvqGZKpXQ5ofxTOuH6pYSOZDsCqPqmaGBdUzBFgauQM",
|
|
"xDEcoODGHIsWd7t9meAFqUtKXndeiKjfP0MMKsttnDohL1kb9mRvHre4VUqMsT5F",
|
|
"...",
|
|
"i3RUtnIHxGi1NqknIY56Hwa3id2yk7cEzvQGAAko/t6PCbe20AfmSQczs7wDNtBD",
|
|
"HgXRyIqIXHYk2+5w+N2eunURIBqCI9uWYK/r81TMR6V84R+XhtvM",
|
|
"-----END RSA PRIVATE KEY-----"
|
|
],
|
|
"deployment_key_protocol": "rsa"
|
|
}
|
|
```
|
|
|
|
- **repository** (*Required*): GIT url to your repository.
|
|
- **auto_restart** (*Optional*): Make a restart of Home-Assistant if the config have change and is valid.
|
|
- **repeat/active** (*Optional*): Pull periodic for GIT updates.
|
|
- **repeat/interval** (*Optional*): Pull all x seconds and look for changes.
|
|
- **deployment_key** (*Optional*): A private SSH key that will be used for communication during git operations. This key is mandatory for ssh-accessed repositories, which are the ones with the following pattern: `<user>@<host>:<repository path>`.
|
|
- **deployment_key_protocol** (*Optional*): The key protocol. Default is "rsa". Valid protocols are:
|
|
|
|
* **dsa**
|
|
* **ecdsa**
|
|
* **ed25519**
|
|
* **rsa**
|
|
|
|
The protocol is typically known by the suffix of the private key --e.g., a key file named `id_rsa` will be a private key using "rsa" protocol.
|