Installation

Requirements

[NodeJS + npm
Redis
Chromium

Steps

Clone the repository and install the dependencies:

git clone https://github.com/muraenateam/necrobrowser.git
cd necrobrowser
npm install

NecroBrowser relies on Redis for data persistence. Redis is expected at tcp://127.0.0.1:6379 (no SSL, no auth). Configure Redis and start it:

redis-server --daemonize yes
redis-cli ping

Setup the environment: create two directories: profiles and extrusion in the root of the project. These will be used to store segregated browser profiles and looted data.

mkdir profiles
mkdir extrusion

Once the installation is done, you can start (possibly in a screen/tmux) the tool with:

node necrobrowser.js

Quick check

You can check if everything is working by running the following command:

curl -X POST "http://127.0.0.1:3000/instrument" \
     -H "Content-Type: application/json" \
     -d '{
          "name": "HelloWorld",
          "task": {
              "type": "generic",
              "name": [ "ScreenshotPages" ],
              "params": { "urls": ["https://example.com/"] }
            }
        }'

This will instruct NecroBrowser to take a screenshot of https://example.com/ and store it in the extrusion directory.