README

Metasploit Framework

The Metasploit Framework is an open-source tool released under a BSD-style license. For detailed licensing information, refer to the COPYING file.

 Latest Version
Access the latest version of Metasploit from the Nightly Installers page.

 Documentation
Comprehensive documentation, including usage guides, is available at Metasploit Docs.

 Development Environment
To set up a development environment, visit the Development Setup Guide.

 Bug and Feature Requests
Submit bugs and feature requests via the GitHub Issues tracker. New submissions can be made through the MSF-BUGv1 form.

 API Documentation
For information on writing modules, refer to the API Documentation.

 Support and Communication
For questions and suggestions, you can:

- Join our GitHub Discussions for community support and general questions
- Join the Metasploit Slack for real-time chat
- Submit GitHub Issues for bug reports and feature requests
- Follow @metasploit on X or @[email protected] on Mastodon for updates

Note: Some community members may still use IRC channels and the metasploit-hackers mailing list, though the primary support channels are now GitHub Discussions and Slack.

 Installing Metasploit

 Recommended Installation

We recommend installation with the official Metasploit installers on Linux or macOS. Metasploit is also pre-installed with Kali.

For a manual setup, consult the Dev Environment Setup guide.

 Using Metasploit

To get started with Metasploit:

1. Start msfconsole: This is the primary interface for interacting with Metasploit.
2. Explore Resources: 
   - Visit the Using Metasploit section of the documentation.

 Contributing

To contribute to Metasploit:

1. Setup Development Environment: Follow the instructions in the Development Setup Guide on GitHub.
2. Clone the Repository: Obtain the source code from the official repository.
3. Submit a Pull Request: After making changes, submit a pull request for review. Additional details can be found in the Contributing Guide.

Top issues

Discussions