mailcow-logs-viewer
A modern, self-hosted dashboard for viewing and analyzing Mailcow mail server logs.
Ficha actualizada 22 sept 2026, 23:56 · upstream 22 sept 2026, 23:41 · release v2.7.1
Qué es mailcow-logs-viewer
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Mailcow Logs Viewer is a comprehensive self-hosted monitoring platform designed to give administrators complete visibility into their Mailcow mail server's operational health. It aggregates logs from multiple components including Postfix, Dovecot, Rspamd, SOGo, Netfilter, ACME, API, Autodiscover, Ratelimited, and Watchdog services into a unified interface. The dashboard provides real-time statistics across 24-hour, 7-day, and 30-day timeframes for key metrics such as messages processed, spam volume, bounce rates, authentication failures, and queue status.
The platform features a powerful message detail view that combines Postfix delivery timelines with Rspamd spam analysis, displaying full symbol tables with scores and descriptions. Administrators can filter messages by sender, recipient, user, IP address, or direction (inbound/outbound/internal) to investigate specific incidents efficiently. The interface supports CSV export of results, displays result counts directly on the page, and offers smart auto-refresh functionality that updates data without manual intervention.
Security is a core focus with integrated Netfilter monitoring that captures failed authentication attempts including IP addresses, usernames, methods used, and actions taken (bans or unbans). A security events chart visualizes bans, unbans, and warnings per country over time. The system includes Fail2Ban management capabilities through the API, allowing administrators to manually ban or unban IPs directly from the dashboard. GeoIP enrichment provides country flags and ASN information for all monitored traffic.
The Spam Filter component offers a dedicated editor for managing Rspamd map files with built-in regex pattern creation tools, while also supporting email suppression lists that automatically block recipients based on bounce patterns. Suppression features include hard bounce detection from Postfix logs, live queue scanning for deferred messages, and progressive blocking with immediate Rspamd synchronization.
Domain management provides DNS validation services including SPF record verification, DKIM key validation against mailcow configuration, and DMARC policy analysis with enforcement r
- Monitor email delivery performance across multiple mail servers in a single dashboard
- Investigate spam campaigns by analyzing Rspamd symbol tables and message details
- Manage quarantine emails with auto-release rules based on sender or recipient patterns
- Validate SPF, DKIM, and DMARC configurations to prevent deliverability issues
- Monitor rate limits and authentication failures across all mail services
- Perform DNS health checks including MX record verification and domain ownership validation
- Track mailbox statistics per user for compliance and quota management
- Generate daily DMARC reports with GeoIP-enriched data for reporting purposes
- Single unified dashboard aggregating logs from 10 different mailcow services including Postfix, Dovecot, Rspamd, SOGo, Netfilter, ACME, API, Autodiscover, Ratelimited, and Watchdog
- Real-time web interface with live log streaming via WebSocket for all monitored components
- Netfilter integration provides detailed security event logging including failed authentication attempts with IP, username, method, and action tracking
- Automated suppression list management that blocks recipients based on hard bounces detected from Postfix logs combined with live queue scanning
- Rspamd Maps editor with built-in regex pattern wizard for creating custom spam filters without external tools
- DMARC report viewer with GeoIP enrichment (MaxMind) providing country and ASN information for compliance reporting
- Full API access via OAuth2/OIDC authentication supporting any standard provider including Mailcow, Keycloak, Auth0, Google, and others
- CSV export functionality allowing bulk data extraction from message details and suppression lists
- Requires an active mailcow instance to function; no standalone deployment option is available
- Read-only API key (MAILCOW_API_KEY) is required for basic operations; read-write access (MAILCOW_API_KEY_RW) needed for edit features like Fail2Ban, queue management, and quarantine editing
- Depends on PostgreSQL 15+ database with at least 512MB RAM minimum requirement
- No native CLI tool or command-line interface provided — all operations must be performed through the web UI
- Real-time log streaming is limited to services explicitly configured in the dashboard; not all mailcow components are automatically included
- GeoIP data requires a paid MaxMind subscription for full country and ASN information
- Rspamd password (RSPAMD_PASSWORD) must be set if using the Spam Filter Maps Editor feature
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Install via Docker Compose with docker-compose.yml and env.example files from the repository's GitHub releases,Configure .env file with required variables: MAILCOW_URL, MAILCOW_API_KEY (read-only), POSTGRES_PASSWORD, and optional RSPAMD_PASSWORD for map editor access,Set appropriate environment variables for timezone (TZ) and fetch interval (FETCH_INTERVAL) to optimize performance,Enable the web UI settings editor by setting SETTINGS_EDIT_VIA_UI_ENABLED=true in .env if you want full configuration management through the browser interface,For production use, deploy with HTTPS using a reverse proxy such as Nginx or Traefik configured to serve mailcow-logs-viewer on port 8080,Use Docker Compose for development and staging environments; migrate to Kubernetes or cloud-native solutions for production deployments,Monitor disk usage — retention is configurable via RETENTION_DAYS environment varia
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.