Development installation

To get started, check the installation instructions in the Github wiki for puavo-users.

The recommended installation is to run it on three servers:

  • LDAP server
  • Puavo-CA server (Rails 3)
  • Puavo server (Rails 2.3 + ActiveLDAP)

Running everything on one server should be also possible. Development has been done on Ubuntu 10.04, but there should be nothing Ubuntu specific in the code.

To get started with Puavo server development, one should know how LDAP works. There are some OpenLDAP tutorials for Ubuntu in Opinsys’s blog.

Developing applications on Puavo

External applications can access data in Puavo using the REST API or native LDAP connections to the LDAP server. Every application gets its own service username and password that it uses to authenticate. Access rights can be defined invidially for each application in the external services settings.

Normal user credentials can also be used to access Puavo. Access rights are the same as the user has in Puavo.


Many existing applications can be integrated easily with Puavo using existing LDAP schemas. TODO: general guide on how to configure web applications to use Puavo's LDAP


Applications can also access data using REST API. The API documentation is still lacking, but is already used by Iivari digital signage system.

Mailing lists

For questions, ideas, comments or any other feedback, there’s a mailing list available at

To join the mailing list, send an empty email to