---

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