Installation

The latest stable release of WarVOX (2.0.0) can be downloaded HERE.

The latest development version of WarVOX can be accessed from GitHub at the following location: https://github.com/rapid7/warvox

WarVOX is designed to run on Linux systems, specifically Ubuntu 12.04 and BackTrack Linux. BSD variants and other Linux distributions are not officially supported, but you may be able to build and use WarVOX on them anyways. To install WarVOX's dependencies, execute the following command from a shell:

$ sudo apt-get install build-essential lame ruby ruby-dev rake rubygems libopenssl-ruby libreadline-ruby gnuplot postgresql postgresql-contrib

Once the dependencies are installed, enter the WarVOX directory and type the following command. This command will compile and configure the necessary tools within the WarVOX directory structure and does not require root privileges.

$ make

At this point you will be prompted to configure a PostgreSQL database for WarVOX to use.

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

Now modify config/database.yml to match the password you set above.

The next step is configure the WarVOX username and password. To change these parameters, edit config/warvox.conf. The default username is admin with a password of warvox. If you intend to dial large ranges and your system has more than one CPU or CPU core, change the analysis_threads value to twice the number of available processing units. Once WarVOX has been configured, execute the following command to start the web interface.

$ bin/warvox.rb

Once the web interface is started, it can be accessed from your browser at the URL http://127.0.0.1:7777/. Enter the username and password from the previous step to login.