Skip to content
This repository

Official repo of the Dradis Framework

Octocat-spinner-32 app Make CSRF work for file uploads in IE July 15, 2012
Octocat-spinner-32 autotest We are trying to get serious with testing. We will be using RSpec December 17, 2010
Octocat-spinner-32 config Clear transient data initializer: don't try to predict how we got her… February 17, 2012
Octocat-spinner-32 core Revert previous commit June 26, 2012
Octocat-spinner-32 db Revert previous commit June 26, 2012
Octocat-spinner-32 doc Start working on the server side code documentation. It was about time. November 19, 2009
Octocat-spinner-32 lib We just released version 2.9.0, master now is the development branch … February 01, 2012
Octocat-spinner-32 public Move assets from public/ to app/assets/ December 28, 2011
Octocat-spinner-32 script Don't depend on a specific Ruby version in the env October 21, 2011
Octocat-spinner-32 spec Spec helper: remove DataBase cleaner for the time being as it is mess… July 19, 2012
Octocat-spinner-32 test Remove the JsonController and all associated files July 05, 2011
Octocat-spinner-32 vendor NmapUpload: detect if service information exists July 15, 2012
Octocat-spinner-32 .gitignore Ignore some Rails files through .gitignore December 28, 2011
Octocat-spinner-32 .rspec We are trying to get serious with testing. We will be using RSpec December 17, 2010
Octocat-spinner-32 .rvmrc With Bundler there is no need for gemsets June 21, 2012
Octocat-spinner-32 .travis.yml Travis:CI test Ruby 1.8, 1.9 and 1.9.3 January 30, 2012
Octocat-spinner-32 CHANGELOG.md Format CHANGELOG.md and remove legacy CHANGELOG September 26, 2012
Octocat-spinner-32 CONTRIBUTING.md Add a CONTRIBUTING.md with a few guidelines September 17, 2012
Octocat-spinner-32 Gemfile Update Gemfile to source from https:// March 03, 2014
Octocat-spinner-32 Gemfile.lock Update to Rails 3.2.6 June 21, 2012
Octocat-spinner-32 README.md Add note on work in dradis3.x to README November 11, 2012
Octocat-spinner-32 Rakefile For the time being do not include the Delayed Job rake tasks until we… November 30, 2010
Octocat-spinner-32 Thorfile Merging back the branch created to bring a bunch of new plugins in li… April 06, 2011
Octocat-spinner-32 config.ru Merging back the Rails 3 branch. October 01, 2010
Octocat-spinner-32 dradis Make the stand-alone binary compatible with Ruby 1.9 June 11, 2011
README.md

Welcome to Dradis

Important note: You're currently viewing the master branch of this repo. This corresponds to Dradis Framework 2.x. Right now we're working on the dradis3.x branch. Once the preliminary work is complete, dradis3.x will become the new master.

Build Status

Dradis is an open source framework to enable effective information sharing, specially during security assessments.

Our goals:

  • Share the information effectively.
  • Easy to use, easy to be adopted. Otherwise it would present little benefit over other systems.
  • Flexible: with a powerful and simple extensions interface.
  • Small and portable. You should be able to use it while on site (no outside connectivity). It should be OS independent (no two testers use the same OS).

Some of the features:

Getting started (git release, recommended)

On Debian-based operating systems (Ubuntu, BackTrack, etc.) use this script:

$ bash < <(curl -s https://raw.github.com/dradis/meta/master/install.sh)

The script:

  1. Checks for system-level dependencies (git, openssl, etc.)
  2. Installs RVM and Ruby 1.9.3. It detects and reuses your existing RVM too.
  3. Downloads and prepares the git repo with Dradis code

View install.sh source

If you want to manually clone the repo:

$ mkdir dradis-git
$ cd dradis-git/
$ git clone https://github.com/dradis/dradisframework.git server

Then download the reset and start scripts to your dradis-git/ folder:

$ curl -O https://raw.github.com/dradis/meta/master/reset.sh
$ curl -O https://raw.github.com/dradis/meta/master/start.sh
$ chmod +x *.sh
$ ./reset.sh

Once the environment is ready, you can start the server with:

$ ./start.sh

And browse to https://localhost:3004 to start using Dradis.

If you would like to make Dradis accessible to other people on the network:

$ ./start.sh -b 0.0.0.0 -p 443

The -b option defines Dradis' bind address and the -p option can be used to change the port.

Getting started (stable release)

In http://dradisframework.org/downloads.html you will find a Windows installer and .tar.gz and .tar.bz2 packages.

Uncompress, verify and prepare the environment:

$ tar xvvjf dradis-vX.Y.Z.tar.bz2
$ cd dradis-vX.Y/
$ ./verify.sh
  # follow instructions / install dependencies
$ ./reset.sh

Once the environment is ready, you can start the server with:

$ ./start.sh

And browse to https://localhost:3004 to start using Dradis. If you need to bind to a different address (so others can connect to your instance) or another port number, you can use the -b and -p switches respectively:

$ ./start.sh -b 10.0.0.123 -p 443

Getting help

Contributing

Please see CONTRIBUTING.md for details.

Many thanks to all Dradis Framework contributors.

License

Dradis Framework is released under GNU General Public License version 2.0

Something went wrong with that request. Please try again.