aboutsummaryrefslogtreecommitdiffstats
path: root/roles/local_homedirs
diff options
context:
space:
mode:
Diffstat (limited to 'roles/local_homedirs')
-rw-r--r--roles/local_homedirs/README.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/roles/local_homedirs/README.md b/roles/local_homedirs/README.md
new file mode 100644
index 0000000..8a42708
--- /dev/null
+++ b/roles/local_homedirs/README.md
@@ -0,0 +1,25 @@
+Local Homedirs
+==============
+
+Description
+-----------
+
+The `local_homedirs` provisions per-user space on the local disk to accomdate
+applications that perform poorly with NFS home directories.
+
+Basically, this role adds some PAM modules and login scripts that cause
+various applications to write to `/usr/local/home/$USER`, rather than
+`/home/$USER`.
+
+This role does not accept any variables.
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- hosts: linux_desktops
+ roles:
+ - role: local_homedirs
+````