Table of Contents

Loading ...

Installing the System


  • Memory: 2 GiB of memory is a tight minimum
  • Storage: 2.5 GiB of storage is a very tight minimum, 8 GiB is comfortable


To install the Unified Communication use case in an all-in-one setup, do the following steps:

  1. Install a Debian 10 Buster system with a default locale with an UTF-8 charset.

  2. Run the following commands as root on the Debian system to provision sudo, git and Ansible:

    apt update
    apt install -yq sudo git ansible curl
  3. Extract the Wazo Platform installer

    git clone
    cd wazo-ansible
  4. (optional) By default, Wazo Platform will install the development version. To install the latest stable version

    git checkout $ansible_tag
  5. Install the Wazo Platform installer dependency

    ansible-galaxy install -r requirements-postgresql.yml
  6. Edit the Ansible inventory in inventories/uc-engine to add your preferences and passwords. The various variables that can be customized are described at

    By default, Wazo Platform will install the development version. To install the latest stable version, activate the following settings in your inventory:

    wazo_distribution = pelican-buster
    wazo_distribution_upgrade = pelican-buster

    If you want to install the web user interface, activate the following in your inventory:


    To create the root account at installation time and be able to use the web user interface and REST APIs, you need to add the following variables:

    engine_api_configure_wizard = true
    engine_api_root_password = ****
  7. Launch the installation by running the following command:

    ansible-playbook -i inventories/uc-engine uc-engine.yml

Use the REST API

You may now use the REST API from outside your system (here

  1. Get an authentication token for 1 hour:

    Using the api_client_name and api_client_password you defined in your inventory, you can execute from the Debian system:

    wazo-auth-cli token create --auth-user <api_client_name> --auth-password <api_client_password>

    Or with curl from anywhere:

    curl -k -X POST -u <api_client_name>:<api_client_password> -H 'Content-Type: application/json' -d '{"expiration": 3600}'
  2. Use any REST API you want, for example, to list the telephony users configured on the system:

    Note: You should replace the following values:

    • my-token with the authentication token
    curl -k -X GET -H 'X-Auth-Token: <my-token>' -H 'Content-Type: application/json' -d '{"firstname": "user1"}'

    Note: the token that you have now only has permissions for configuration REST API (wazo-confd).

Optional post-install steps

You may now follow the optional post-install steps.