Tip on Using My GitHub Repos

I was recently asked what would be the best way to use my Metasploit projects in a an easy manner, so I will share how I did my setup for both OS X and Backtrack for using my plugins and modules. Let start first with creating a Development folder in the users home directory to house the GitHub repos

mkdir ~/Development

After this you can clone the repos in to this folder:

cd ~/Deveolpment
git clone https://github.com/darkoperator/Metasploit-Plugins.git msf_plugins
git clone https://github.com/darkoperator/Meterpreter-Scripts.git msf_modules

Now we can link the modules to our ~/.msf4 directory so we can use them transparently with any instance of the framework we might be running on the machine:

ln -s ~/Development/msf_plugins/ ~/.msf4/plugins
ln -s ~/Development/msf_modules/ ~/.msf4/modules

To keep them updated is just a simple git pull in each directory to get the latest changes and bug fixes.

Update on Monday, February 13, 2012 at 10:17PM by Carlos Perez

After postting the tip I got feedback from people that told me that the links wehere not working for Linux users, the reason is that ln works differently in OS X from Linux. On Linux the commands are:

ln -s ~/Development/msf_plugins ~/.msf4/plugins
ln -s ~/Development/msf_modules ~/.msf4/modules

The difference is the slash at the end of the path to link.

Comments

[Digz]

Having trouble getting Metasploit to search ~/.msf4/ for plugins/modules.
Is there a configuration file that needs tweaking?

[Carlos Perez]

Sadly search does not search in the users module, plugin nor script paths, you do have the capability of doing tab complete when loading or using the modules, scripts and plugins

[bonsaiviking]

On linux, you need to make sure ~/.msf4/modules doesn't already exist, or ln will create ~/.msf4/modules/msf_modules/

Same for ~/.msf4/plugins