Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Official repo of the Dradis Framework
Ruby CSS HTML JavaScript Shell ApacheConf CoffeeScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
autotest
config
core/db/migrate
db
doc
lib
public
script
spec
test
vendor
.gitignore
.rspec
.rvmrc
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
Gemfile
Gemfile.lock
README.md
Rakefile
Thorfile
config.ru
dradis

README.md

Welcome to Dradis

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.