Metasploit

Metasploit cc9c104bc8 automatic module_metadata_base.json update 2 weeks ago
.github 93953313b2 Use latest Ruby 3.3 releases during tests 4 weeks ago
app e5c636f931 Move folder descriptions into README.md files 1 year ago
config 67770d5684 Fix bootsnap warning when booting msfrpc service 10 months ago
data bea708d24c Add exploit module for CVE-2024-5084: WordPress Hash Form Plugin RCE 4 weeks ago
db cc9c104bc8 automatic module_metadata_base.json update 2 weeks ago
docker ce10038546 Replace grep with getent in entrypoint.sh 8 months ago
docs 97e8e5ca02 Bump rexml from 3.2.5 to 3.2.7 in /docs 2 weeks ago
documentation 120fa0f2fe Land #19208, Add exploit module for CVE-2024-5084: WordPress Hash Form Plugin RCE 3 weeks ago
external e5635c4bfd Add source code for Python deserialization gadgets 2 months ago
kubernetes ee093d0c21 Meterpreter Helm chart tweaks 2 years ago
lib bf177642b4 Land #19199, Improves UX for scanner/login modules 2 weeks ago
modules bf177642b4 Land #19199, Improves UX for scanner/login modules 2 weeks ago
plugins 2d819cb029 remove db_create mention 2 months ago
script e5c636f931 Move folder descriptions into README.md files 1 year ago
scripts 742326ae90 Actually add script contents 1 month ago
spec d604d28b27 Land #19197, SQL sessions have correct history manager support 2 weeks ago
test e693b9588c Update ldap modules to support an ldap session 1 month ago
tools d09053cde5 Add the viewstate generator as an option 3 months ago
.dockerignore e9da06a645 change docker root exec 5 years ago
.git-blame-ignore-revs b18fe5c6af Update git-blame-ignore-revs to ignore tabs to spaces commits 2 years ago
.gitignore d4b9473294 Ignore .solargraph.yml config file 1 year ago
.gitmodules 468654d2b5 Add RDI submodule, port Kitrap0d 10 years ago
.mailmap 4dd3e43f01 Remove wvu from list at his request, and move past contributors to appropriate section 1 year ago
.rspec 692e53501e Add modern --require to .rspec 9 years ago
.rubocop.yml 61f70e09f6 detect invalid Pack/Unpack directives 10 months ago
.ruby-gemset 4e1820a668 Remove gitignore, change to metasploit-framework 10 years ago
.ruby-version c4e55f1493 Update ruby version 1 month ago
.simplecov b863978028 Remove fastlib 9 years ago
.solargraph.yml 4f70be41ae Removed lib include line as it became redundant 1 year ago
.yardopts 50c168415c remove HACKING from yardopts 6 years ago
CODE_OF_CONDUCT.md b82506f323 Update CODE_OF_CONDUCT.md 1 year ago
CONTRIBUTING.md 1782ae1ff2 Fix up links within Wiki site to make them relative links where possible 1 year ago
COPYING 7d486b3374 Update LICENSE and COPYING 4 years ago
CURRENT.md bfa7e32c91 add CURRENT.md to track major changes and how to migrate with them 6 years ago
Dockerfile c4e55f1493 Update ruby version 1 month ago
Gemfile 97a3e0291e Bump ruby_smb to 3.3.2 5 months ago
Gemfile.local.example 94c34200f1 Add in fix to use relative paths for Gemfile.local.example, thereby fixing review comments 3 years ago
Gemfile.lock aab1e5c029 Routine security updates 2 weeks ago
LICENSE 1058291af9 Land #18314, Windows Error Reporting RCE (CVE-2023-36874) 9 months ago
LICENSE_GEMS a9078b4d68 Bump version of framework to 6.4.13 2 weeks ago
README.md ff775b7b23 Remove stale documentation link 3 months ago
Rakefile 1617b3ec9b Use zeitwerk for lib/msf/core folder 3 years ago
Vagrantfile bbec35f8ba moves v.gui comment to appropriate location(s) 3 years ago
cortex.yaml 6cefa8f3d2 PD-41096 Auto-add cortex.yaml 8 months ago
docker-compose.override.yml e9da06a645 change docker root exec 5 years ago
docker-compose.yml b641e25b6d docker: hassle-free DB bootstrap 3 years ago
metasploit-framework.gemspec dbeeadefc7 Add osx aarch64 exec payload 3 weeks ago
msf-json-rpc.ru 67770d5684 Fix bootsnap warning when booting msfrpc service 10 months ago
msf-ws.ru 67770d5684 Fix bootsnap warning when booting msfrpc service 10 months ago
msfconsole b81252e34f Add support for ruby 3.3.0-preview2 8 months ago
msfd d6896dadc0 remove `msf` folder requires 3 years ago
msfdb 6659684fdf Land #18440, Add remote webservice deletion notice 7 months ago
msfrpc b833a7a421 Remove extra `require` for a now deleted file that no longer exists 3 years ago
msfrpcd f779f0f482 consolidate the config directory lookups 1 year ago
msfupdate 92cec6116b we don't need ruby-backports anymore (or maybe we can use it more conditionally on Ruby 2.6), it uses a lot of memory 4 years ago
msfvenom 5124219fb6 Generate machine readable msfvenom output when pipes are used 3 years ago

README.md

Metasploit Maintainability Test Coverage 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://docs.metasploit.com/docs/using-metasploit/getting-started/nightly-installers.html

You can find documentation on Metasploit and how to use it at: https://docs.metasploit.com/

Information about setting up a development environment can be found at: https://docs.metasploit.com/docs/development/get-started/setting-up-a-metasploit-development-environment.html

Our bug and feature request tracker can be found at: https://github.com/rapid7/metasploit-framework/issues

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://docs.metasploit.com/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 the basics of using Metasploit or Metasploit Unleashed.

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.