---
labels:
- 'Stage-Alpha'
- 'Type-Auth'
summary: PAM authentication module
---
Introduction
============
This module makes Prosody authenticate users against PAM (Linux
Pluggable Authentication Modules)
Dependencies
============
The module depends on [lua-pam](https://github.com/devurandom/lua-pam)
and [LuaPosix](https://github.com/luaposix/luaposix).
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