Metasploit

Metasploit d6b45658e0 automatic module_metadata_base.json update 14 hours ago
.github e5cf357f9e Land #19078, ldap acceptance tests 5 days ago
app e5c636f931 Move folder descriptions into README.md files 1 year ago
config 67770d5684 Fix bootsnap warning when booting msfrpc service 9 months ago
data 26a108aadc Land #19046, Apache Solr Backup Restore RCE [CVE-2023-50386] 6 days ago
db d6b45658e0 automatic module_metadata_base.json update 14 hours ago
docker ce10038546 Replace grep with getent in entrypoint.sh 6 months ago
docs aeafa4a756 Land #19088, Add docs for running and writing Metasploit's unit tests 1 week ago
documentation 364d491af7 Land #18972, Progress LoadMaster unauthenticated command injection module CVE-2024-1212 3 days ago
external e5635c4bfd Add source code for Python deserialization gadgets 1 month ago
kubernetes ee093d0c21 Meterpreter Helm chart tweaks 2 years ago
lib 434186200a Land #19141, Apache RocketMQ & ActiveMQ fixes 14 hours ago
modules 434186200a Land #19141, Apache RocketMQ & ActiveMQ fixes 14 hours ago
plugins 2d819cb029 remove db_create mention 3 weeks ago
script e5c636f931 Move folder descriptions into README.md files 1 year ago
scripts de53f45e68 fix spelling in scripts folder 3 months ago
spec 6c74d14bb7 Tested attempt to fix rspec 21 hours ago
test e5cf357f9e Land #19078, ldap acceptance tests 5 days ago
tools d09053cde5 Add the viewstate generator as an option 2 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 11 months 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 9 months ago
.ruby-gemset 4e1820a668 Remove gitignore, change to metasploit-framework 10 years ago
.ruby-version 6126598d16 Update Ruby version to 3.0.5 from 3.0.2 to fix security issues and compatibility 1 year ago
.simplecov b863978028 Remove fastlib 9 years ago
.solargraph.yml 4f70be41ae Removed lib include line as it became redundant 11 months 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 8dcb409d25 Fix BUNDLER_CONFIG_ARGS variable mismatch in Dockerfile 2 months ago
Gemfile 97a3e0291e Bump ruby_smb to 3.3.2 3 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 76d7fe8dbd Land #19095, Refactor smb_enumusers 4 days ago
LICENSE 1058291af9 Land #18314, Windows Error Reporting RCE (CVE-2023-36874) 7 months ago
LICENSE_GEMS b607c70611 Bump version of framework to 6.4.7 5 days ago
README.md ff775b7b23 Remove stale documentation link 1 month 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 7 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 651f137e94 Routine Gem dependencies update 1 week ago
msf-json-rpc.ru 67770d5684 Fix bootsnap warning when booting msfrpc service 9 months ago
msf-ws.ru 67770d5684 Fix bootsnap warning when booting msfrpc service 9 months ago
msfconsole b81252e34f Add support for ruby 3.3.0-preview2 6 months ago
msfd d6896dadc0 remove `msf` folder requires 3 years ago
msfdb 6659684fdf Land #18440, Add remote webservice deletion notice 5 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 2 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.