Open Banner Grabbing System
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

OBGS - Open Banner Grabbing System


##Automatic installation

There is an script under the folder that will install OBGS and its dependencies with a configuration by default.

WARNING: This script is still under development so use it at your own risk!

##Manual installation

First, install dependencies. For example, with a debian based system:

$ sudo apt-get install npm nodejs-legacy mongodb-server nginx
$ sudo pip install pymongo==2.9.1
$ sudo pip install eve
$ sudo npm install -g bower gulp

Then, we need to install masscan

$ sudo apt-get install git gcc make libpcap-dev
$ git clone
$ cd masscan
$ make
$ sudo make install

We need to add a iptables filter to grab the banners

iptables -A INPUT -p tcp --dport 60000 -j DROP

Reference masscan's readme for further instructions.

When deploying in a server, if systemd is available:

$ sudo cp install/obgs-farmer.service /etc/systemd/system/
$ sudo cp install/obgs-api.service /etc/systemd/system/
$ sudo systemctl daemon-reload
$ sudo systemctl start obgs-farmer.service obgs-api.service


Use gulp to compile the frontend, and setup apache/nginx to serve the public folder (see wiki for config examples)

$ cd frontend
$ npm install
$ bower install
$ gulp


Edit to match the MongoDB settings and the data schema.

Use systemd service to control the api service, or run manually api/


Use systemd service to control the farmer service, or run manually farmer/