Go to file
Grant Willcox f71a6e914a
Update session_notifier.rb to change the SSL file checks to use .file? instead of .exists?
2021-05-12 17:19:12 -05:00
.github Replace third-party github labels app with standalone github actions 2021-04-21 10:13:08 +01:00
app Rails 5 file validator need guard for `nil` 2020-07-31 11:56:49 -05:00
config Remove travis config files 2021-01-11 10:28:14 +00:00
data Land #14869, Add Windows post module for gathering Exchange mailboxes 2021-03-26 15:08:06 -05:00
db automatic module_metadata_base.json update 2021-04-30 17:04:04 -05:00
docker remove debug output 2018-10-21 22:34:19 +02:00
documentation Land #15105, CVE-2021-21220 - Chrome V8 XOR typer mismatch OOB access RCE 2021-04-30 22:56:07 +01:00
external Only upgrade the token of EProcess was found 2021-03-16 15:20:44 -04:00
lib Land #15116, more flexible time parse 2021-04-30 09:25:46 -04:00
modules Land #15105, CVE-2021-21220 - Chrome V8 XOR typer mismatch OOB access RCE 2021-04-30 22:56:07 +01:00
plugins Update session_notifier.rb to change the SSL file checks to use .file? instead of .exists? 2021-05-12 17:19:12 -05:00
script kill cucumber in framework 2017-07-12 08:00:29 -05:00
scripts Zeitwerk `rex` folder 2021-02-08 12:24:12 +00:00
spec Land #14831, Add CookieJar support to http_client 2021-04-30 14:08:04 +01:00
test Add a meterpreter test for enumerating core commands 2021-02-19 15:51:39 -06:00
tools fix tools author 2021-04-30 18:34:52 +07:00
.dockerignore change docker root exec 2018-10-21 22:30:01 +02:00
.gitignore Land #9220, Module cache improvements 2018-01-17 22:34:51 -06:00
.gitmodules Add RDI submodule, port Kitrap0d 2013-11-27 16:04:41 +10:00
.mailmap Add smashery to mailmap 2021-04-22 10:37:03 +10:00
.rspec Add modern --require to .rspec 2014-10-08 10:55:40 -05:00
.rubocop.yml rubocop files and make the exclusions more localised 2021-03-15 13:27:37 +00:00
.ruby-gemset Remove gitignore, change to metasploit-framework 2013-09-13 12:44:19 -05:00
.ruby-version bump default ruby version to 2.7.2 2020-10-20 11:28:06 -05:00
.simplecov Remove fastlib 2014-09-18 15:24:21 -05:00
.yardopts remove HACKING from yardopts 2017-09-07 02:35:56 -05:00
CODE_OF_CONDUCT.md Change individual contacts 2018-12-13 10:38:55 -06:00
CONTRIBUTING.md Update issue link in readme 2021-01-04 12:06:27 +00:00
COPYING Update LICENSE and COPYING 2020-01-18 18:45:37 -06:00
CURRENT.md add CURRENT.md to track major changes and how to migrate with them 2018-01-18 06:35:53 -06:00
Dockerfile download version of get-pip supporting python2 2021-01-25 09:59:56 -06:00
Gemfile Lock ruby-prof until nightly builds can use c11 2021-02-19 08:42:28 -06:00
Gemfile.local.example Add in fix to use relative paths for Gemfile.local.example, thereby fixing review comments 2020-09-24 09:25:03 -05:00
Gemfile.lock Land #14831, Add CookieJar support to http_client 2021-04-30 14:08:04 +01:00
LICENSE Add Process Herpaderping evasion module and binaries 2021-01-22 18:33:10 +01:00
LICENSE_GEMS Bump version of framework to 6.0.43 2021-04-29 12:08:05 -05:00
README.md Added the link for 'COPYING' file 2019-10-07 13:16:15 +05:30
Rakefile Use zeitwerk for lib/msf/core folder 2020-12-07 10:31:45 +00:00
Vagrantfile moves v.gui comment to appropriate location(s) 2020-10-08 11:59:09 -05:00
docker-compose.override.yml change docker root exec 2018-10-21 22:30:01 +02:00
docker-compose.yml docker: hassle-free DB bootstrap 2021-01-08 16:20:11 +01:00
metasploit-framework.gemspec Land #14831, Add CookieJar support to http_client 2021-04-30 14:08:04 +01:00
msf-json-rpc.ru Add health check functionality 2021-04-16 01:59:22 +01:00
msf-ws.ru Use zeitwerk for lib/msf/core folder 2020-12-07 10:31:45 +00:00
msfconsole Use zeitwerk for lib/msf/core folder 2020-12-07 10:31:45 +00:00
msfd remove `msf` folder requires 2021-01-18 14:21:54 +00:00
msfdb Fix db connection support for rpc service 2021-04-02 05:30:34 +01:00
msfrpc Remove extra `require` for a now deleted file that no longer exists 2021-03-02 10:57:07 +00:00
msfrpcd remove `msf` folder requires 2021-01-18 14:21:54 +00:00
msfupdate 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 2019-12-02 09:03:58 -06:00
msfvenom Handle modules failing to be created when checking compatibility 2021-03-10 14:36:38 +00:00

README.md

Metasploit Build Status 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://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.