wydler/parsedmarc-docker
GitHub: wydler/parsedmarc-docker
Stars: 11 | Forks: 0
# EPK (Elastic, parsedmarc, Kibana)
[](https://hub.docker.com/r/wydler/parsedmarc-app) [](https://hub.docker.com/r/wydler/parsedmarc-app) [](https://hub.docker.com/r/wydler/parsedmarc-app) [](https://hub.docker.com/r/wydler/parsedmarc-app)
## Overview
A Python package and CLI for parsing aggregate, forensic DMARC and TLS/MTA-STS reports,
This is a port of the native [parsedmarc application](https://github.com/domainaware/parsedmarc) into docker images.
## Requirements
* Docker & Docker Compose V2
* SSH/Terminal access (able to install commands/functions if non-existent)
## Install Docker, download containers und configure parsedmarc
1. This script will install docker and containerd:
curl https://raw.githubusercontent.com/wydler/parsedmarc-docker/master/misc/02-docker.io-installation.sh | bash
{
"experimental": true,
"ip6tables": true
}
3. Clone the repository to the correct folder for docker container:
git clone https://github.com/wydler/parsedmarc-docker.git /opt/containers/parsedmarc-docker
git -C /opt/containers/parsedmarc-docker checkout $(git -C /opt/containers/parsedmarc-docker tag | tail -1)
4. Change the ownership for the elasticsearch data directory:
sudo chown -R 1000:root /opt/containers/parsedmarc-docker/data/elasticsearch/
5. Create the .env file with random passwords:
/bin/bash /opt/containers/parsedmarc-docker/setup-epk.sh
6. Editing `/opt/containers/parsedmarc-docker/.env` and set your parameters and data. Any change requires an restart of the containers.
7. Editing `/opt/containers/parsedmarc-docker/docker-compose.yml` and set your parameters for the application.
8. Starting application with `docker compose -f /opt/containers/parsedmarc-docker/docker-compose.yml up -d`.
9. Don't forget to test, that the application works successfully (e.g. http(s)://IP-Addresse or FQDN/).
## Update parsedmarc
1. When you're ready to update the code, you can checkout the latest tag:
( cd /opt/containers/parsedmarc-docker/ && git fetch && git checkout $(git tag | tail -1) )
2. No restart needed. The changes will take effect immediately.