aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJulien Dessaux2023-01-23 17:33:53 +0100
committerJulien Dessaux2023-01-23 23:12:56 +0100
commitb6ee8f76c2883a934bcf412722e0cf83830173c9 (patch)
tree97d33cb1f4ea74e0b277a4ed6890b35bc022816e /README.md
parentImported from personal ansible repository (diff)
downloadsyncthing-ansible-role-b6ee8f76c2883a934bcf412722e0cf83830173c9.tar.gz
syncthing-ansible-role-b6ee8f76c2883a934bcf412722e0cf83830173c9.tar.bz2
syncthing-ansible-role-b6ee8f76c2883a934bcf412722e0cf83830173c9.zip
Simplify fact gathering by using the cli instead of a webapi request1.1
Diffstat (limited to '')
-rw-r--r--README.md13
1 files changed, 11 insertions, 2 deletions
diff --git a/README.md b/README.md
index 40166b2..004f678 100644
--- a/README.md
+++ b/README.md
@@ -10,14 +10,23 @@ I wanted a role to install and configure syncthing for me and did not find an ex
- the validation of host_vars which virtually no role in the wild ever does
- the ability to manage an additional inventory file for devices which ansible cannot manage (like my phone)
+## Dependencies
+
+This role relies on `doas` being installed and configured so that your ansible user can run the syncthing cli as the syncthing user.
+
+Here is an example of a `doas.conf` that works for the ansible user:
+```yaml
+permit nopass ansible as syncthing
+```
+
## Role variables
There is a single variable to specify in the `host_vars` of your hosts: `syncthing`. This is a dict that can contain the following keys:
- address: optional string to specify how to connect to the server, must match the format `tcp://<hostname>` or `tcp://<ip>`. Default value is *dynamic* which means a passive host.
- shared: a mandatory dict describing the directories this host shares, which can contain the following keys:
- name: a mandatory string to name the share in the configuration. It must match on all devices that share this folder.
- - path: the path of the folder on the device. This can difer on each device sharing this data.
- - peers: a list a strings. Each item should be either the ansible_hostname of another device, or a hostname from the `syncthing_data.yaml` file
+ - path: the path of the folder on the device. This can differ on each device sharing this data.
+ - peers: a list a strings. Each item should be either the `ansible_hostname` of another device, or a hostname from the `syncthing_data.yaml` file
Configuring a host through its `host_vars` looks like this:
```yaml