Install the Metasploit Framework on Apple Mac OS X

Document created by mjc on Mar 25, 2011Last modified by mjc on May 22, 2013
Version 3Show Document
  • View in full screen mode

Mac OS X 10.5 (Leopard) and 10.6 (Snow Leopard) come pre-installed with Ruby 1.8, but we recommend that you install Ruby 1.9 from MacPorts instead.

Install MacPorts

  1. Make sure you have Xcode installed -
  2. Download and install the .dmg from MacPorts -

Verify that MacPorts is up to date

$ sudo port selfupdate

Install Ruby 1.9.1

Once MacPorts has been configured, you can install a new version of Ruby and RubyGems with the following command:

$ sudo port install ruby19 +nosuffix

This will install ruby into /opt/local/


For a complete listing of all the files that were installed, run:

$ port contents ruby19

You should verify that your PATH is set correctly such that /opt/local/bin is listed before /usr/bin.

$ echo $PATH
$ which ruby gem

Install a database (optional)

Some Metasploit Framework functionality requires a database. We support and recommend using postgres. That said, the Metasploit Framework also contains drivers for MySQL.



$ sudo env PATH=/opt/local/lib/postgresql84/bin/:$PATH
$ sudo port install postgresql84-server
$ sudo gem install pg



$ sudo port install mysql5-server
$ sudo gem install mysql

Install and use the Metasploit Framework


Once Ruby and RubyGems have been properly installed, download the Unix tarball from the Metasploit Framework Website and extract it to the directory of your choice. Change into the framework3 directory and execute msfconsole to get started.