Metasploit Framework
Ruby JavaScript PowerShell Assembly HTML Cucumber
Failed to load latest commit information.
.github Fix link Feb 22, 2016
app Move shared example from pro into framework Apr 7, 2016
config Land #6556, include Vagrant development environment provisioner Jun 9, 2016
data Land #7151, Improve CVE-2016-0099 reliability Jul 29, 2016
db still trying to fix these migrations May 11, 2016
documentation Land #6965, centreon useralias exec Jul 26, 2016
external Land #7068, Introduce 'mettle' - new POSIX meterpreter Jul 11, 2016
features Apparently the tests expected the typo in DATABASE. Jul 28, 2016
lib Land #7121, Don't clobber nil strings when there are empty strings in… Jul 29, 2016
modules Fix #7158, tiki_calendar_exec incorrectly reports successful login Jul 28, 2016
plugins Tweek migration - Check rights to process before migrate Jul 10, 2016
script rails generate cucumber:install Aug 27, 2014
scripts Land #6625, Send base64ed shellcode and decode with certutil (Actuall… Jul 28, 2016
spec Rex::OLE is now rex-ole gem, fixes MS-1712 Jul 25, 2016
test Revert "Land #6812, remove broken OSVDB references" Jul 15, 2016
tools Revert "Land #6812, remove broken OSVDB references" Jul 15, 2016
.gitignore Merge branch 'master' into vagrant Feb 20, 2016
.gitmodules Add RDI submodule, port Kitrap0d Nov 27, 2013
.mailmap And Thao, too! Jul 1, 2016
.rspec Add modern --require to .rspec Oct 8, 2014
.rubocop.yml Reapply PR #4113 (removed via #4175) Nov 11, 2014
.ruby-gemset Restoring ruby and gemset files May 20, 2014
.ruby-version bump ruby version to 2.3.1 May 3, 2016
.simplecov Remove fastlib Sep 18, 2014
.travis.yml bump ruby version to 2.3.1 May 3, 2016
.yardopts Various merge resolutions from master <- staging Aug 15, 2014
CODE_OF_CONDUCT.md Add individual contacts Jan 13, 2016
CONTRIBUTING.md Add note about issues to CONTRIBUTING.md Jun 30, 2016
COPYING Update COPYING, too. Jan 4, 2016
Gemfile fix deps May 13, 2016
Gemfile.local.example Various merge resolutions from master <- staging Aug 15, 2014
Gemfile.lock Bump version of framework to 4.12.17 Jul 29, 2016
HACKING Update link for The Metasploit Development Environment Jul 15, 2014
LICENSE Update copyright notice to 2016 [ci skip] Jan 3, 2016
README.md Use SVG badges to please the eyes 👀 Dec 13, 2015
Rakefile Merge branch 'feature/MSP-11130/metasploit-framework-spec-constants' … Nov 5, 2014
Vagrantfile switch to inline provisioning, use official ubuntu vagrant box Jun 9, 2016
metasploit-framework.gemspec update to mettle 0.0.6 Jul 27, 2016
msfbinscan Fix -h exit status for Omnibus Sep 4, 2015
msfconsole @wvu-r7 is a skilled negotiator. s/stdout/stderr/ Oct 17, 2014
msfd Initialize the DisableBanner option Oct 8, 2015
msfelfscan Fix -h exit status for Omnibus Sep 4, 2015
msfmachscan Fix -h exit status for Omnibus Sep 4, 2015
msfpescan Fix -h exit status for Omnibus Sep 4, 2015
msfrop Fix -h exit status for Omnibus Sep 4, 2015
msfrpc Change {} back to do/end Mar 9, 2015
msfrpcd allow overriding the default timeout for a session May 1, 2015
msfupdate File.exists? must die Apr 21, 2016
msfvenom reenable jar format May 9, 2016

README.md

Metasploit Build Status Code Climate

The Metasploit Framework is released under a BSD-style license. See COPYING for more details.

The latest version of this software is available from: https://metasploit.com

Bug tracking and development information can be found at: https://github.com/rapid7/metasploit-framework

New bugs and feature requests should be directed to: http://r-7.co/MSF-BUGv1

API documentation for writing modules can be found at: https://rapid7.github.io/metasploit-framework/api

Questions and suggestions can be sent to: https://lists.sourceforge.net/lists/listinfo/metasploit-hackers

Installing

Generally, you should use the free installer, which contains all of the dependencies and will get you up and running with a few clicks. See the Dev Environment Setup if you'd like to deal with dependencies on your own.

Using Metasploit

Metasploit can do all sorts of things. The first thing you'll want to do is start msfconsole, but after that, you'll probably be best served by reading Metasploit Unleashed, the great community resources, or the wiki.

Contributing

See the Dev Environment Setup guide on GitHub, which will walk you through the whole process from installing all the dependencies, to cloning the repository, and finally to submitting a pull request. For slightly more information, see Contributing.