DMARQ

DMARQ is a modern, privacy-conscious DMARC monitoring and analysis platform built for professionals who want deep visibility into their email authentication posture — without giving up control or relying on third-party SaaS providers.

🌐 Live Demo (soon)
🔒 Self-hosted. Secure. Beautifully visual.
🛠️ Docker-deployable. Cloudflare-integrated.
📬 Aggregate & forensic report support.

---

💡 What is DMARQ?

DMARQ ingests and visualizes DMARC (Domain-based Message Authentication, Reporting & Conformance) reports — both aggregate and forensic — to help domain owners understand who is sending emails on their behalf and whether those messages are properly authenticated using SPF and DKIM.

No more guessing. See which services are passing DMARC, which are failing, and how to fix them — all in one clear dashboard.

---

✨ Key Features

📊 Dashboard & Reports

• DMARC Compliance Rate: Track pass/fail rates over time
• Enforcement Rate: Visualize policy strength and adoption
• Volume & Trends: Identify traffic spikes and anomalies
• Top Sending Sources: Detect unknown or unauthorized senders
• Forensic Reports: Analyze failure samples (RFC 6591 support)

🛡 DNS Record Health

• Inspect SPF, DKIM, DMARC, MX, and BIMI records
• Show which records are missing, broken, or invalid
• Get fix suggestions tailored to your provider (e.g., Google, Microsoft)
• 🔒 No automatic changes — all DNS updates require explicit confirmation

🌐 Cloudflare Integration

• Automatically discover domains in your Cloudflare account
• Fetch and analyze relevant DNS records
• Suggest missing or malformed entries
• Track configuration changes over time (coming soon)

⚙️ Web-Based Setup Wizard

• Guided onboarding experience (no CLI setup required)
• Store all configuration in a secure internal database
• Seed config with environment variables for headless deployment

🚨 Alerts & Notifications

• Integration with Apprise
• Email, Slack, webhook, and more
• Alert on new failures, compliance drops, or unknown senders

🔐 User Management

• Built-in authentication via FastAPI Users
• JWT-secured API endpoints
• Admin dashboard access control

---

🚀 Getting Started

You can deploy DMARQ in minutes using Docker Compose:

git clone https://github.com/YOUR_USERNAME/dmarq.git
cd dmarq
cp .env.example .env
docker compose up --build

Then visit http://localhost:8000 to launch the config wizard and connect your inbox & Cloudflare account.

---

📦 Requirements

• IMAP inbox for DMARC reports (e.g. dmarc@yourdomain.com)
• Cloudflare API token (read access to zones and DNS)
• Docker + Docker Compose
• DMARC reporting enabled for your domain (via rua= and ruf=)

---

🧪 Status

• ✅ DMARC aggregate & forensic report ingestion
• ✅ Dashboard & alerting
• ✅ Web-based config wizard
• ✅ Docker-based deployment
• 🔜 Rule-based alerts
• 🔜 Multi-tenant support
• 🔜 Self-updating DNS snapshot history

---

📘 License

MIT License — you are free to use, modify, and host DMARQ for any purpose.

---

🤝 Contributing

Pull requests are welcome! Please open an issue to discuss major features or design ideas before submitting code. Full contributing guide coming soon.

---

🛡 Why DMARQ?

Unlike most commercial DMARC tools, DMARQ gives you:

• 🔍 Full visibility without third-party access to your reports
• 🧠 Intelligence-driven suggestions, not just raw data
• 🎨 A beautiful, intuitive dashboard with real-time insights
• 💻 Self-hosted flexibility with modern developer practices

Let’s build better email security — together.