1 Prerequisites

We are assuming a Linux environment although most of the guide will be applicable to other platforms.

In order to run Dradis under Apache and mod_rails, we need to install Apache and the Passenger gem:

1. apt-get install apache2
2. gem install passenger

You need to load Apache’s SSL module:

1. a2enmod ssl

And Passenger’s Apache module:

1. passenger-install-apache2-module

Passenger’s install instructions are very thorough, but you can always check the User’s guide.

If you are running Debian lenny, you may need to update your Ruby gems installation:

1. gem install rubygems-update
   
2. /var/lib/gems/1.8/bin/update_rubygems

Once you have Apache and mod_passenger running, the worst is over, you just need to configure a Dradis virtual host.

2 Get Dradis

You can either download the latest release or checkout the latest and greatest version from the subversion repository.

For the examples we will assume that Dradis is found in /home/etd/dradis

3 Reset the Dradis environment

Passenger will run Dradis in production mode, so we need to make sure that the production database is properly configured. Go to the Dradis folder and first make sure you have all the required dependencies:

$ ./verify.sh

Install anything that is missing (the script provides instructions) and then initialize the environment with:

$ ./reset.sh

This will initialize the production SQLite3 database (~/dradis/server/db/production.sqlite3). You can use other engines like MySQLor Postgres. See the configuration page for more details on how to do this.

4 Configure Dradis VirtualHost

Create a new Dradis file under /etc/apache2/sites-available/:

<VirtualHost default:443>
  SSLEngine on
  SSLCertificateFile /home/etd/dradis/server/config/ssl/server.crt
  SSLCertificateKeyFile /home/etd/dradis/server/config/ssl/server.key.insecure

  SSLProtocol all -SSLv2
  ServerName dradis
  DocumentRoot /home/etd/dradis/server/public
</VirtualHost>

Save the file and enable the virtual host:

1. a2ensite dradis
   
2. /etc/init.d/apache2 reload
   

Dradis should be ready to use at:

https://localhost/

If for some reason this doesn’t work, remember to check out the logs in the log/ folder in the directory you uncompressed Dradis and feel free to ask in the forums or the mailing list.