Metasploit Framework
Ruby C Python JavaScript PowerShell Assembly Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Add documentation requirement to PR template Apr 5, 2017
app Move shared example from pro into framework Apr 7, 2016
config Land #6556, include Vagrant development environment provisioner Jun 9, 2016
data Add correct filename for `/etc/group` May 21, 2018
db automatic module_metadata_base.pstore update May 22, 2018
docker another approach Feb 17, 2018
documentation Lad #10017, D-Link DSL-2750B Unauthenticated OS Command Injection May 22, 2018
external Land #8795, Added CVE-2016-0040 Windows Privilege Escalation May 3, 2018
lib Land #10081, unnecessary class definition fix May 22, 2018
modules Land #10024, Fix find_or_create_* methods for remote data service May 22, 2018
plugins Land #10024, Fix find_or_create_* methods for remote data service May 22, 2018
script kill cucumber in framework Jul 12, 2017
scripts Fixed Typos Feb 27, 2018
spec Land #10024, Fix find_or_create_* methods for remote data service May 22, 2018
test Land #9246, Support RHOSTS for exploit modules May 16, 2018
tools refresh standalone psexec a bit May 7, 2018
.dockerignore Fix docker build Mar 6, 2018
.gitignore Land #9220, Module cache improvements Jan 18, 2018
.gitmodules Add RDI submodule, port Kitrap0d Nov 27, 2013
.mailmap Add mkienow to the mailmap Jan 7, 2018
.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 bump to ruby 2.5.1 Mar 30, 2018
.simplecov Remove fastlib Sep 18, 2014
.travis.yml Update .travis.yml May 7, 2018
.yardopts remove HACKING from yardopts Sep 7, 2017
CODE_OF_CONDUCT.md Add individual contacts Jan 13, 2016
CONTRIBUTING.md include example of why PRs from master are bad May 8, 2018
COPYING Update COPYING Jan 9, 2018
CURRENT.md add CURRENT.md to track major changes and how to migrate with them Jan 18, 2018
Dockerfile bump to ruby 2.5.1 Mar 30, 2018
Gemfile remove case for open smb file packet field May 7, 2018
Gemfile.local.example update Gemfile.local example, use Gemfile.local if it exists when bun… Apr 30, 2017
Gemfile.lock update kiwi plugin, add dcshadow and powershell streaming support May 21, 2018
LICENSE Remove external module license from LICENSE file Mar 21, 2018
LICENSE_GEMS Update rex-text to 0.2.17 Apr 8, 2018
README.md 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 more docker work Nov 28, 2017
docker-compose.yml more docker work Nov 28, 2017
metasploit-framework.gemspec update kiwi plugin, add dcshadow and powershell streaming support May 21, 2018
msfconsole Improved CTRL-C edge case, Invalid Options edge case, help output, ve… Mar 20, 2018
msfd Removing unnecessary spaces Sep 12, 2017
msfdb_ws key file isnt always necessary, but cert is. Feb 5, 2018
msfrpc Removing unnecessary spaces Sep 12, 2017
msfrpcd Removing unnecessary spaces Sep 12, 2017
msfupdate remove "require 'os'", not needed or available May 14, 2018
msfvenom Land #9869, Add support for shellcode encryption for msfvenom Apr 25, 2018

README.md

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: 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: https://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: Freenode IRC channel or e-mail the metasploit-hackers mailing list

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.