Ruby HTML JavaScript CoffeeScript CSS Makefile
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
app Removing links that are not implemented yet #16 Sep 8, 2016
bin Further Rails 5 fixes (#6) Oct 17, 2016
config Further Rails 5 fixes (#6) Oct 17, 2016
db Updating all files to Ruby 1.9 hash syntax Sep 5, 2016
lib Updating all files to Ruby 1.9 hash syntax Sep 5, 2016
spec Updating all files to Ruby 1.9 hash syntax Sep 5, 2016
.gitignore Further Rails 5 fixes (#6) Oct 17, 2016
.ruby-version Bumping ruby version for ruby_dep Aug 22, 2016
Gemfile Further Rails 5 fixes (#6) Oct 17, 2016
Gemfile.lock Further Rails 5 fixes (#6) Oct 17, 2016
Guardfile added rspec test suite, annotate gem to help illustrate models better… Oct 23, 2015
Makefile Further Rails 5 fixes (#6) Oct 17, 2016
Rakefile Permissions, ignorable Dec 27, 2012 Permissions, ignorable Dec 27, 2012


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