Configure and launch

Before you start...

... make sure you have all the prerequisites as detailed in the install and setup page.

Download, configure and launch

  1. download Dradis
  2. download the required ruby gems and initialise the environment
  3. configure the database
  4. launch the server

download Dradis

This is an easy one, go to the download page and get the latest version. Unpack in a directory of your choice and cd to that directory.

back to top

download the required ruby gems

Starting with Dradis 2.6, all Ruby dependencies are managed through Bundler.

The Dradis reset script will download and install all the necessary libraries for you the first time you run it.

In Windows, there is a reset link in the Start menu group or you can go to the installation folder and run:

reset.bat

In *NIX simply run:

reset.sh

The script will use Bundler to install all the dependencies listed in ./server/Gemfile and will set up the environment for first use.

configure the database

If you are using SQLite3 (as recommended), there is nothing to configure, jump to the next step: launch the server.

Otherwise, if you want to configure Dradis to connect to a different engine, for example MySQL, open ./dradis/server/config/database.yml in the Dradis server folder and adjust the following values:

example config for MySQL
adapter: mysql
database: dradis
username: root
password:
# You may need to adjust the value below to your platform/distribution default.
# See MySQL documentation for more information.
socket: /var/run/mysqld/mysqld.sock

More information on how to configure different database drivers using Ruby on Rails (RoR) can be found at the HowtosDatabase page of the RoR wiki.

back to top

launch the server

In Windows use the start server link or go to the Dradis folder and run:

start.bat

In *NIX just run:

start.sh

You can verify that everything is running as it should by pointing your browser to:

https://localhost:3004/

You can customise parameters such as network interface or port number by editing the startup script.

Using the -p switch you can specify the port number. By default Dradis listens at port 3004.

By default Dradis listens in the local loopback (127.0.0.1), however, it is possible to launch the server to listen in a different interface with the -b parameter:

For instance to run Dradis on 10.0.1.23 and port 8888, the script should read:

ruby script\rails server -b 10.0.1.23 -p 8888

You can also run Dradis in Apache instead of as a separate server.

back to top