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. configure the database
3. initialise 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

configure the database

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

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

initialise the database

In order to populate the database we will use the rake tool. In the server directory (cd ./dradis/server/) run:

rake dradis:reset

This should initialize the database schema and populate the default values required by the application.

back to top

launch the server

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

ruby ./script/server

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:

ruby ./script/server -b 10.0.0.7

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

https://localhost:3004/

back to top