Skip to content

Configuration service for Wazo using REST APIs


Notifications You must be signed in to change notification settings


Repository files navigation


Build Status

wazo-confd is a micro-service that provides a RESTful API for configuring and managing a Wazo server. Further details on how to use the API can be found on the Wazo API documentation

Installing wazo-confd

The server is already provided as a part of Wazo Platform. Please refer to the documentation for further details on installing one.


Launching wazo-confd

wazo-confd [--user <user>] --config-file <path/to/config/file>

On a Wazo Platform environment, wazo-confd is launched automatically at system boot via a systemd service.


Running unit tests

apt-get install libpq-dev python-dev libffi-dev libyaml-dev
pip install tox
tox --recreate -e py39

Running integration tests

You need Docker installed.

cd integration_tests
pip install -U -r test-requirements.txt
make test-setup
make test


  • pip install gprof2dot
  • apt-get install graphviz
  • set the profile directory configuration
  • process file in directory with the following command:

gprof2dot -f pstats <directory>/<file> | dot -Tpng -o output.png


Modified database

You need the repos xivo-manage-db up-to-date.

  1. git clone
  2. MANAGE_DB_DIR=../../xivo-manage-db make update-db
  3. Execute the steps above to run integration tests

Modified wazo-provd

You need the repos wazo-provd up-to-date.

  1. git clone
  2. PROVD_DIR=../../wazo-provd make build-provd
  3. Execute the steps above to run integration tests

Mounting libraries

In case you need to mount libraries (xivo-dao, wazo-bus, lib-python) inside the wazo-confd container:

  1. Uncomment the confd volumes in integration_tests/assets/docker-compose.yml
  2. Set the environment variable: export LOCAL_GIT_REPOS=/parent/directory/to/all/git/repos
  3. Execute the steps above to run integration tests

How to get help

If you ever need help from the Wazo Platform community, the following resources are available:


You can learn more on how to contribute in the Wazo Platform documentation.


wazo-confd is released under the GPL 3.0 license. You can get the full license in the LICENSE file.