diff options
Diffstat (limited to 'roles/syncthing')
-rw-r--r-- | roles/syncthing/README.md | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/roles/syncthing/README.md b/roles/syncthing/README.md new file mode 100644 index 0000000..51d95a2 --- /dev/null +++ b/roles/syncthing/README.md @@ -0,0 +1,56 @@ +Syncthing +========= + +Description +----------- + +The `syncthing` role installs [Syncthing](https://syncthing.net/) and +configures a dedicated Syncthing instance for each specified user. + +Using the exported `syncthing_apache_config` block, users are able to access +their server GUI by navigating to `https://$HOSTNAME/$USERNAME/` (GSSAPI +authentication is used). + +Note that if you use NFS home directories, you'll need to whitelist the +Syncthing host for non-Kerberized NFS. Each user's Syncthing instance runs +under their own UID, and I haven't yet figured out a good way to shuffle +keytabs around. + + +Variables +--------- + +This role **accepts** the following variables: + +Variable | Default | Description +--------------------------------|---------|------------ +`syncthing_users` | `{}` | Mapping of usernames to unique Syncthing ports +`syncthing_fs_watcher_enabled` | no | Use inotify (doesn't work on NFS) +`syncthing_rescan_interval_sec` | 60 | Folder rescan interval (seconds) + +This role **exports** the following variables: + +Variable | Description +--------------------------|------------ +`syncthing_archive_shell` | Shell command to make a backup tarball of the Syncthing configuration + +Usage +----- + +Example playbook: + +````yaml +- name: configure syncthing + hosts: syncthing1 + roles: + - role: syncthing + vars: + syncthing_users: + johndoe: 22001 + janedoe: 22002 + anotheruser: 22003 + + - role: apache_vhost + apache_default_vhost: yes + apache_config: '{{ syncthing_apache_config }}' +```` |