SunRed/parsedmarc-dockerized
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
Dockerized self-initializing parsedmarc docker stack for lazy people
25 commits 1 branch 0 tags 67 KiB
Shell 85.3%
Dockerfile 14.7%
Find a file
Manuel 0a53061459
All checks were successful
continuous-integration/drone/push Build is passing
Details
Add badge
2021-10-17 22:01:38 +02:00
data Several changes and updated formatting 2021-10-17 20:40:03 +02:00
.drone.yml Update '.drone.yml' 2021-10-17 21:54:24 +02:00
.gitignore Improved setup and README 2020-08-08 23:02:00 +01:00
compose.yml Change images and documentation 2021-10-17 21:01:51 +02:00
LICENSE Update 2020-08-08 23:28:40 +01:00
README.md Add badge 2021-10-17 22:01:38 +02:00

README.md

parsedmarc-dockerized

Build Status

Note: The standalone parsedmarc docker image on DockerHub @ sunred/parsedmarc can also be used, if interested.

Setup:

  1. Get basics together:
git clone https://git.snrd.de/sunred/parsedmarc-dockerized.git /opt/parsedmarc-dockerized/
cd /opt/parsedmarc-dockerized/ && cp data/conf/parsedmarc/config.sample.ini data/conf/parsedmarc/config.ini
  1. Next we change the parsedmarc config (see docs. You can set Test to True for testing purposes.)
nano data/conf/parsedmarc/config.ini

  1. To use the geoip updater for automatic geo location resolution you have to create an account on the MaxMind website and add your license key you can retrieve from your account page to data/conf/geoipupdate.env. More information in the documentation.

  2. Finally, we start up the stack and wait:

docker-compose up -d

What's happening then?

  1. First, containers of the stack are created and started. This might take a while, as several containers have dependencies on others being in a healthy state (meaning that its service must be fully started).
  2. During the startup of the parsedmarc-init container, all required steps and preparations are being taken care of - like generating a self-signed certificate for the included nginx webserver.
  3. Once the Kibana container - where you can view the dashboards - is started up, the corresponding parsedmarc dashboards are automatically imported into Kibana by the parsedmarc-init container.
  4. After a while, when everything is up and running, you can then access Kibana and its dashboards at localhost:5601 that you can reverse proxy on your host system.

Credits

Built with awesome parsedmarc, Elasticsearch and Kibana, Docker and MaxMind GeoIP.