Install and setup

1. before you start
2. download and install ruby
3. get SQLite3
4. download the required ruby gems
5. download, configure and launch dradis

before you start

You should be aware that this information has been superseded by the release of the Windows one-click installer.

back to top

download and install ruby

In order to use dradis, you will need to download and install the ruby language interpreter for your platform. It is recommended to use the One-Click Ruby Installer for Windows.

Appart from the ruby interpreter, there are other tools and packages required by dradis (Rake and RubyGems), however these are already included in the One-CLick Ruby Installer.

back to top

get SQLite3

SQLite3 is a lightweight database engine. It stores the entire contents of a database in a single file, thus it is very convenient for us.

The only thing you need to do is to download the SQLite3 .dll from the project's download page and place it in your windows\system32 directory.

At the time of this writting the latest stable version of this .dll is 3.5.6 and it can be downloaded from: http://www.sqlite.org/sqlitedll-3_5_6.zip.

back to top

download the required ruby gems

Because ruby is an interpreted language, it needs bindings to link to some native libraries:-

sqlite3-ruby gem

Open a console (Startup => Run => cmd.exe) and type the following:-

C:\>gem install sqlite3-ruby
Bulk updating Gem source index for: http://gems.rubyforge.org
Select which gem to install for your platform (i386-mswin32)
  1. sqlite3-ruby 1.2.1 (mswin32)
  2. sqlite3-ruby 1.2.1 (ruby)
  3. sqlite3-ruby 1.2.0 (mswin32)
  4. sqlite3-ruby 1.2.0 (ruby)
  5. Skip this gem
  6. Cancel installation
>

Select 1.

wxruby gem

wxWidgets is the library used to build dradis' graphical interface. wxruby are the bindings needed to use wxWidgets inside ruby. To install them, open a console and type:-

C:\>gem install wxruby
Select which gem to install for your platform (i386-mswin32)
  1. wxruby 1.9.4 (x86_64-linux)
  2. wxruby 1.9.4 (x86-linux)
  3. wxruby 1.9.4 (i386-mswin32)
  4. wxruby 1.9.3 (x86-linux)
  5. wxruby 1.9.3 (i386-mswin32)
  6. wxruby 1.9.3 (universal-darwin)
  7. Skip this gem
  8. Cancel installation
>

And select 3. Please make sure that you select the version 1.9.4 of the gem. The wxruby people have released a few versions afterwards and dradis was built with the 1.9.4 release.

You may need to get yourself a copy of MSVCP71.dll and MSVCR71.dll if they are not already in your system. A quick search in Google will do the trick (they are freely available). Once you have downloaded them, place a copy in your windows\system32 directory.

back to top

download, configure and launch dradis

Platform independent instructions are provided in the download, configure and launch page.

back to top

If you need more information try the full user manual or the documentation page.