Installing the System

Please refer to the section Troubleshooting if ever you have errors during the installation.

There are two official ways to install Wazo:

  • using the official ISO image
  • using a minimal Debian installation and the Wazo installation script

Wazo can be installed on both virtual (QEMU/KVM, VirtualBox, …) and physical machines. That said, since Asterisk is sensitive to timing issues, you might get better results by installing Wazo on real hardware.


For a small install of about 20 users, less than 20 calls per day:

  • RAM: 2 GiB with 1 GiB swap
  • Storage: 2.5 GiB of storage is a very tight minimum, 8 GiB is comfortable

Installing from a minimal Debian installation

Wazo can be installed directly over a 32-bit or a 64-bit Debian 10 Buster. When doing so, you are strongly advised to start with a clean and minimal installation of Debian 10 Buster.

The latest installation image for Debian 10 Buster can be found at


The installed Debian must:

  • use the architecture i386 or amd64
  • have a default locale with charset UTF-8

In case you want to migrate a Wazo from i386 to amd64, see Migrate Wazo from i386 (32 bits) to amd64 (64 bits).


Once you have your Debian 10 Buster properly installed, download the Wazo installation script and make it executable:

chmod +x

And run it:


At the end of the installation, you can continue by running the configuration wizard.

Alternatives versions

The installation script can also be used to install a specific version of Wazo. For example, if you want to install Wazo 16.16:

./ -a 16.16

You may also install development versions of Wazo with this script. These versions may be unstable and should not be used on a production server. Please refer to the usage of the script:

./ -h