Setup development environment

Seccubus development on Mac OS X

I recently switched from a Windows laptop to a Macbook and this means I now have a portable development environment on me at all times.

This document details what you have to do to set up a development environment on Mac OS X.

Check out the code

I checked out my code in ~/Repos with the following command

cd ~/Repos
git clone

I suggest that you actually first fork the repository to your own github account and clone from there. In my case the clone command was:

git clone

Setting up the database

I installed mysql via Homebrew

brew install mysql
mysql.server start

(!) Warning a standard mysql environment is not secure by default

Setting up perl and mysql

Make sure you have perl installed via homebrew

brew install perl
brew link --overwrite perl # If needed

First we need to setup cpanm, I do this via Homebrew

brew install cpanm

Next install the missing CPAN modules:

cpanm --installdeps . --sudo

By default Seccubus wqill look for its configuration in /opt/seccubus. It is best to create a symlink to your repository from this location

cd /opt
sudo ln -s ~/Repos/Seccubus seccubus

Setting up Seccubus

Go to you repository. And create a config file

cd ~/Repos/Seccubus
cp config.xml
vi config.xml

Change the database to the correct database

Starting Seccubus in development mode

Server available at

Surf to and follow setup instructions on the status tab to create the database and populate it.

mysql -u root << EOF
create database seccubus;
grant all privileges on seccubus.* to seccubus@localhost identified by 'seccubus';
flush privileges;

mysql -uroot seccubus < ~/Repos/Seccubus/db/structure_v10.mysql # Make sure this is the latest version available
mysql -uroot seccubus < ~/Repos/Seccubus/db/data_v10.mysql

Done. Default admin password is ‘GiveMeVulns!’.