Are you anxious to get your [Metasploit Development Environment](https://github.com/rapid7/metasploit-framework/wiki/Setting-Up-a-Metasploit-Development-Environment) set up and start [[Landing Pull Requests]] and contribute excellent exploit code? If so, you're in the right place.

Are you a Metasploit user, and want to hack stuff (that you have permission to hack) just like in the movies? The quickest way to get started is to [download the Metasploit binary installer](http://www.rapid7.com/products/metasploit/download.jsp). This will give you access to all Metasploit editions: the free, open source Metasploit Framework, the free Metasploit Community edition, and a free
trial of Metasploit Pro.

If you’re using [Kali Linux](http://kali.org), Metasploit is already pre-installed; just type `msfconsole`
in the terminal to start Metasploit Framework, then type `go_pro` if you’d like to use try Metasploit Pro
or Metasploit Community.

If you're an exploit developer, you will want to review our [[Guidelines for Accepting Modules and Enhancements]] to find out what all we expect when we see pull requests for new Metasploit modules. No idea what you should start working on? Check out the guidelines for [[contributing to Metasploit]], and dive in
to [[Setting Up a Metasploit Development Environment]].

# Getting Started #

- [[Setting Up a Metasploit Development Environment]] 
- [[Using Metasploit]]
- [[Using Git]]
- [[Reporting a Bug]]

# Contributing #

- **[[Creating Metasploit Framework LoginScanners]]** - new in 4.10!
- [[Guidelines for Accepting Modules and Enhancements]]
- [[Contributing to Metasploit]]
- [[Common Metasploit Module Coding Mistakes]]
- [[Style Tips]]
- [[Committer Rights]]
- [[Landing Pull Requests]]

# Metasploit Resources #

- [[Downloads by Version]]
- [[How to use a Metasploit module appropriately]]
- [[How to use a reverse shell in Metasploit]]
- [[Evading Anti Virus]]
- [[Loading External Modules]]
- [[Exploit Ranking]]
- [[How Payloads Work]]
- [[State of Meterpreter]]
- [[Metasploit module reference identifiers]]
- [[How to get started with writing an exploit]]
- [[How to get started with writing an auxiliary module]]
- [[How to get started with writing a post module]]
- [[How to get started with writing a Meterpreter script]]
- [[How to use Railgun for Windows post exploitation]]
- [[How to write a browser exploit using BrowserExploitServer]]
- [[Information About Unmet Browser Exploit Requirements]]
- [[How to write a browser exploit using HttpServer]]
- [[How to write a module using HttpServer and HttpClient]]
- [[How to Send an HTTP Request Using HTTPClient]]
- [[How to send an HTTP request using Rex::Proto::Http::Client]]
- [[How to write a check() method]]
- [[How to use WbemExec for a write privilege attack on Windows]]
- [[How to use the Seh mixin to exploit an exception handler]]
- [[How to Use the FILEFORMAT mixin to create a file format exploit]]
- [[How to use Powershell in an exploit]]
- [[How to use PhpEXE to exploit an arbitrary file upload bug]]
- [[How to use Msf::Auxiliary::AuthBrute to write a bruteforcer]]
- [[How to do reporting or store data in module development]]
- [[How to clean up files using FileDropper]]
- [[How to use datastore options]]
- [[How to obfuscate JavaScript in Metasploit]]
- [[How to log in Metasploit]]
- [[How to deprecate a Metasploit module]]
- [[How to use the Msf::Exploit::Remote::Tcp mixin]]
- [[How to check Microsoft patch levels for your exploit]]
- [[How to zip files with Rex::Zip::Archive]]
- [[What does my Rex::Proto::SMB Error mean?]]

# GitHub Resources #

- [[Remote Branch Pruning]]
- [[Git Cheatsheet]]
- [[Git Gotchas]]
- [[Git Reference Sites]]