Email Header Dissector (EHeaD), written in Python and based on Flask aiming at parsing email headers and clearly displaying the information in a human readable format. EHeaD identifies:

• hop delays
• the source of the email
• hop country

NOTE: the tool's name, EHeaD, it to be pronounced e-hɛd (just like e-head)

Clone the GitHub repo:

$ git clone https://github.com/carmelo0x99/email-header-dissector.git EHeaD

Create a Python3 virtual environment and activate its dependencies:

$ cd email-header-dissector

$ python3 -m venv .

$ source bin/activate

$ python3 -m pip install -r requirements.txt

Run the development server:

$ cd ehead

$ python3 server.py -d

To make the server accessible from other hosts the following command can be run:

$ python3 server.py -d -b 0.0.0.0 -p 8080

The following (or similar) messages shall be shown on the console:

 * Serving Flask app 'server'
 * Debug mode: on
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:8080
Press CTRL+C to quit

If that is the case, the application can be reached as follows: http://localhost:8080.

A Dockerfile is provided if you wish to build a Docker image.

$ docker build -t ehead:latest .

You can then run a container with:

$ docker run -d -p 8080:8080 ehead:latest

A docker-compose file is provided if you wish to use docker-compose.

Clone the GitHub repo:

$ git clone https://github.com/carmelo0x99/email-header-dissector.git
$ cd email-header-analyzer

Let docker-compose do the work.

$ docker-compose up -d

Stop the container.

$ docker-compose down

HowTo enable debugging. Add in the docker docker-compose.yaml file the line

command: --debug