Metasploit Framework
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github update PR template to ask for unique branch Jan 5, 2019
app Move shared example from pro into framework Apr 7, 2016
config Land #6556, include Vagrant development environment provisioner Jun 9, 2016
data Land #11230, add JuicyPotato local privilege escalation Jan 16, 2019
db automatic module_metadata_base.json update Dec 29, 2018
docker remove debug output Oct 21, 2018
documentation Land #11243, Add ASan SUID Privesc Jan 22, 2019
external chore: update juicy potato reflective DLL source to latest Jan 12, 2019
lib Land #11275, Fix a typo in command_dispatcher/core.rb Jan 22, 2019
modules Land #11243, Add ASan SUID Privesc Jan 22, 2019
plugins Pass down workspace too report_web_site Jan 19, 2019
script kill cucumber in framework Jul 12, 2017
scripts Fixed Typos Feb 27, 2018
spec Update test for new cred methods Jan 18, 2019
test fix loadpath test/modules Nov 20, 2018
tools Land #11125, Import/generate `ysoserial` Java serialization objects Jan 15, 2019
.dockerignore change docker root exec Oct 21, 2018
.gitignore Land #9220, Module cache improvements Jan 18, 2018
.gitmodules Add RDI submodule, port Kitrap0d Nov 27, 2013
.mailmap revisionism Jan 11, 2019
.rspec Add modern --require to .rspec Oct 8, 2014
.rubocop.yml Land #9986, initial ruby_smb simple client integration May 7, 2018
.ruby-gemset Restoring ruby and gemset files May 20, 2014
.ruby-version new ruby Oct 19, 2018
.simplecov Remove fastlib Sep 18, 2014
.travis.yml update travis to use latest rubygems Jan 3, 2019
.yardopts remove HACKING from yardopts Sep 7, 2017 Change individual contacts Dec 13, 2018 Update Dec 13, 2018
COPYING Update COPYING Jan 9, 2018 add to track major changes and how to migrate with them Jan 18, 2018
Dockerfile Land #10843, change docker root exec behaviour Nov 2, 2018
Gemfile Require swagger-blocks in dev and test May 23, 2018
Gemfile.local.example update Gemfile.local example, use Gemfile.local if it exists when bun… Apr 30, 2017
Gemfile.lock Bump version of framework to 5.0.2 Jan 18, 2019
LICENSE remove cpuinfo from license Dec 11, 2018
LICENSE_GEMS Bump version of framework to 5.0.2 Jan 18, 2019 add docker pull badge to readme Dec 6, 2017
Rakefile trying rspec-retry Jun 20, 2017
Vagrantfile fix #8693, update Vagrant to latest rvm syntax Jul 11, 2017
docker-compose.override.yml change docker root exec Oct 21, 2018
docker-compose.yml change docker root exec Oct 21, 2018
metasploit-framework.gemspec Move msfdb_ws since it is deprecated by msfdb Jan 10, 2019 Move under Msf::WebServices namespace Nov 26, 2018 Add Metasploit data web service rackup file Jan 15, 2019
msfconsole Improved CTRL-C edge case, Invalid Options edge case, help output, ve… Mar 20, 2018
msfd Removing unnecessary spaces Sep 12, 2017
msfdb Remove unused code Jan 15, 2019
msfrpc Removing unnecessary spaces Sep 12, 2017
msfrpcd Add background process ID output Jan 9, 2019
msfupdate remove "require 'os'", not needed or available May 14, 2018
msfvenom Land #10802, Make `msfvenom -f` case-insensitive Nov 21, 2018

Metasploit Build Status Code Climate Docker Pulls

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

The latest version of this software is available from:

Bug tracking and development information can be found at:

New bugs and feature requests should be directed to:

API documentation for writing modules can be found at:

Questions and suggestions can be sent to: Freenode IRC channel or e-mail the metasploit-hackers mailing list


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.


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.