Ruby HTML JavaScript CoffeeScript CSS Makefile
Latest commit a1f6730 Jul 2, 2016 @hdm hdm Prevent overwrite


WarVOX is released under a BSD-style license. See docs/LICENSE for more details.

The latest version of this software is available from

Questions and suggestions can be sent to: x(at)hdm(dot)io


WarVOX 2.0.0 is still in development and the installation process is not ideal at the moment.


WarVOX requires a Linux operating system, preferably Ubuntu or Debian, but Kali should work as well.

WarVOX requires PostgreSQL 9.1 or newer with the "contrib" package installed for integer array support.

To get started, install the OS-level dependencies:

$ sudo apt-get install gnuplot lame build-essential libssl-dev libcurl4-openssl-dev \ 
  postgresql postgresql-contrib postgresql-common git-core curl libpq libpq-dev

Install RVM to obtain Ruby 2.1.5 or later

$ \curl -L | bash -s stable --autolibs=3 --rails

After RVM is installed you need to run the rvm script provided

$ source /usr/local/rvm/scripts/rvm

In case you have not installed Ruby 1.9.3 or later by now, do so using RVM.

$ rvm install ruby-2.1

Clone this repository to the location you want to install WarVOX:

$ git clone git:// /home/warvox

Configure WarVOX:

$ cd /home/warvox
$ bundle install
$ make

Verify your installation:

$ bin/verify_install.rb

Configure the PostgreSQL account for WarVOX:

$ sudo su - postgres
$ createuser -s warvox
$ createdb warvox -O warvox
$ psql
psql> alter user warvox with password 'randompass';
psql> exit
$ exit

Copy the example database configuration to database.yml:

$ cp config/database.yml.example config/database.yml

Modify config/database.yml to include the password set previously

Initialize the WarVOX database:

$ make database

Add an admin account to WarVOX

$ bin/adduser admin

Start the WarVOX daemons:

$ bin/warvox.rb 

Access the web interface at

At this point you can configure a new IAX2 provider, create a project, and start making calls.