Skip to content


With Ansible you can get the same results as with the manual setup but fully automatic and reproducible. However it is missing some features, for example it is not able to install with nginx or uWSGI.


Since Ansible runs on your local machine, the available installation methods differ depending on your operating system, so please have a look on the official installation instructions. If you are on Windows, we recommend you to use WSL.


Ansible is an advanced topic which can get quite complex. If you have never used it before, we recommend you to take a look at a tutorial first.

Then get the Ansible role for Peering Manager by running ansible-galaxy install gmazoyer.peering_manager. Later updates can be installed with ansible-galaxy install gmazoyer.peering_manager --force. The role will install and configure Python, PostgreSQL, Redis, Apache and Peering Manager on Debian or Ubuntu.


When the Ansible remote user is not root, the package acl is required and has to be installed before running this role.

Please also make sure that the choosen database locale is already installed or this role will fail. This could be done with community.general.locale_gen.


These are the most important configuration options you shold know. For more detailed information, please see the Ansible role repository.

Variable Default Notes
peering_manager_database peering-manager
peering_manager_database_user peering-manager
peering_manager_database_password peering-manager
peering_manager_database_host localhost PostgreSQL will only be set up if this is set to localhost. Otherwise, an existing database will be used.
peering_manager_database_lc en_US.UTF-8
peering_manager_install_directory /opt/peering-manager
peering_manager_superuser_username admin
peering_manager_superuser_password admin
peering_manager_setup_systemd false Set to true to set up gunicorn and the Peering Manager worker units.
peering_manager_setup_web_frontend false Set to true to configure Apache web server.
peering_manager_config ALLOWED_HOSTS:
- localhost
Allowed hosts are used for hostnames in Apache config
peering_manager_setup_cron_jobs true Set up cron for regular Peering Manager tasks