Metasploit

adfoster-r7 9d8aa6cfa0 Test nokogiri compilation fix 4 months ago
.github 79011250d2 Add support for Ruby 3.3 4 months 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 fb26c93291 Land #18541, Glibc Tunables Privilege Escalation CVE-2023-4911 (Looney Tunables) 5 months ago
db 08beaddf0a automatic module_metadata_base.json update 4 months ago
docker ce10038546 Replace grep with getent in entrypoint.sh 7 months ago
docs a9f5c11d68 Land #18484, add ability to follow payload override in shell to meterpreter 4 months ago
documentation 2028fbd226 Land #18404, Working Module for CVE-2023-38146 4 months ago
external 86b7ec4518 Address comments from the review 7 months ago
kubernetes ee093d0c21 Meterpreter Helm chart tweaks 2 years ago
lib 8d4142a8c7 Fix the save command when dns_feature is disabled 4 months ago
modules 79011250d2 Add support for Ruby 3.3 4 months ago
plugins 0fcba5ee17 Land #17970, Fix #17969 Assign empty hash to variable status 8 months ago
script e5c636f931 Move folder descriptions into README.md files 1 year ago
scripts e70f356239 Show errors on inaccessible payload files 7 months ago
spec a9f5c11d68 Land #18484, add ability to follow payload override in shell to meterpreter 4 months ago
test 00cfbc357a Update error message for meterpreter file contents test 4 months ago
tools 1f6009333e Add history support to nasm and metasm shells 7 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 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 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 b336bcaf30 updated Dockerfile for arm architectures 5 months ago
Gemfile 9d8aa6cfa0 Test nokogiri compilation fix 4 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 9d8aa6cfa0 Test nokogiri compilation fix 4 months ago
LICENSE 1058291af9 Land #18314, Windows Error Reporting RCE (CVE-2023-36874) 7 months ago
LICENSE_GEMS d7f2ed4e4a Bump version of framework to 6.3.51 4 months ago
README.md aceb4c57c6 Remove references to Travis CI since we no longer use it and now use GitHub Actions 1 year 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 79011250d2 Add support for Ruby 3.3 4 months 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 7 months ago
msfd d6896dadc0 remove `msf` folder requires 3 years ago
msfdb 6659684fdf Land #18440, Add remote webservice deletion notice 6 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 Metasploit Unleashed, the great community resources, or take a look at the Using Metasploit page on the documentation website.

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.