--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_auth_pam/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,30 @@
+---
+labels:
+- 'Stage-Alpha'
+- 'Type-Auth'
+summary: PAM authentication module
+...
+
+Introduction
+============
+
+This module makes Prosody authenticate users against PAM (Linux
+Pluggable Authentication Modules)
+
+Setup
+=====
+
+Create a `/etc/pam.d/xmpp` with something like this:
+
+    auth    [success=1 default=ignore]  pam_unix.so obscure sha512 nodelay
+    auth    requisite           pam_deny.so
+    auth    required            pam_permit.so
+
+And switch authentication provider in the Prosody config:
+
+    authentication = "pam"
+
+Compatibility
+=============
+
+Compatible with 0.9 and up