Install the Metasploit Framework on Apple Mac OS X

Version 3

    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 - http://developer.apple.com/tools/xcode/
    2. Download and install the .dmg from MacPorts - http://www.macports.org/

    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
    /opt/local/bin:/opt/local/sbin:/usr/bin:/bin:/usr/sbin:/sbin
     
    $ which ruby gem
    /opt/local/bin/ruby
    /opt/local/bin/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.


     

    PostgreSQL:

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

     

    MySQL:


    $ 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.