aboutsummaryrefslogtreecommitdiffstats
path: root/roles/unifi
diff options
context:
space:
mode:
Diffstat (limited to 'roles/unifi')
-rw-r--r--roles/unifi/README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/roles/unifi/README.md b/roles/unifi/README.md
new file mode 100644
index 0000000..18e128a
--- /dev/null
+++ b/roles/unifi/README.md
@@ -0,0 +1,35 @@
+Unifi
+=====
+
+Description
+-----------
+
+The `unifi` role installs the [UniFi](https://www.ui.com/wi-fi) controller, a
+web application used to manage Ubiquiti's UniFi line of wireless access points.
+
+This role currently requires Rocky Linux 8 due to unavailability of packages
+in EPEL 9.
+
+
+Variables
+---------
+
+This role does not accept any variables.
+
+This role **exports** the following variables:
+
+Variable | Description
+----------------------|------------
+`unifi_archive_shell` | Shell command to backup UniFi configuration data
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- name: configure unifi controller
+ hosts: unifi_controllers
+ roles:
+ - role: unifi
+````