Skip to content
This repository has been archived by the owner on May 18, 2021. It is now read-only.


Repository files navigation


Notice: WarVOX is currently unsupported and unmaintained. YMMV.

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: research[at]


WarVOX requires a Linux operating system, preferably Ubuntu or Debian.

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-dev sox

Install RVM to obtain Ruby 2.2.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 2.2.5 or later by now, do so using RVM.

	$ rvm install ruby-2.2.5

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

	$ git clone git:// /opt/warvox

Configure WarVOX:

	$ cd /opt/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

Copy the example secrets configuration to secrets.yml:

	$ cp config/secrets.yml.example config/secrets.yml

Create a new secrect token:

	$ rake secret > config/session.key

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 randompass

Start the WarVOX daemons:

	$ bin/warvox

or to bind WarVox to all interfaces:

	$ bin/warvox --address

Access the web interface at

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


To get assets to show up, you need to first compile assets in production environment:

RAILS_ENV=production bundle exec rake assets:precompile

This will compile all static assets into public folder.

Next, you need to enable the RAILS_SERVE_STATIC_FILES environment variable through the terminal:


or wrap the above in a .env file and run source:

source .env