Mailcow logs viewer: A faster, cool way to monitor your emails

shlomi · 2025-12-25T18:47:39+00:00

Hi everyone, While mailcow is an amazing suite, I often found the built-in log viewing options a bit clunky when I needed to debug something quickly (its ev...

Cisco30

shlomi
Ok I’m going to write a report

bpsintl

shlomi No I didn’t configure MaxMind

Cisco30

bpsintl
We need to track the issue on GitHub now…

CK_beats

Many thanks from me for the update version 2!
Great job!
Flawless!
Very good and extremely informative!

Finally a simple and quick way to view DMARC reports.
We had actually received bug reports on 12/23/2025 that I had missed.

shlomi

Well this project is not just “logs” anymore.
We need a new name.
I’m open to suggestions

DocFraggle

shlomi What about “Mailcow Cockpit”? It literally shows everything relevant to monitor the stack 🙂

shlomi

DocFraggle
Not everything yet, but we’re getting there.

maybl8

I changed my ISP and I am getting errors on Mailcow log viewer and don’t know what to check.
It is not showing domain info. Mail is working in and out.

Containers
Total

1

Running

0

Stopped

1

detail

Unknown

unknown
Mailcow System
Failed to load system info: HTTP 500: Internal Server Error

Storage
Failed to load storage info: HTTP 500: Internal Server Error

Import Status
Postfix Logs

Last Fetch Run

01/18/2026, 09:31:09

Last Import

01/17/2026, 14:17:26

Total Entries

26,127

Oldest Entry

01/05/2026, 14:21:47

Rspamd Logs

Last Fetch Run

01/18/2026, 09:31:09

Last Import

01/17/2026, 14:01:27

Total Entries

5,278

Oldest Entry

01/05/2026, 09:38:11

Netfilter Logs

Last Fetch Run

01/18/2026, 09:31:09

Last Import

01/17/2026, 14:07:27

Total Entries

5,395

Oldest Entry

01/05/2026, 16:03:53

Message Correlation Status
753

Total

610

Complete

0

Incomplete

59

Expired

81.01%

Success Rate

Last updated: 01/17/2026, 14:01:56

Background Jobs
Fetch Logs
Imports logs from Mailcow API

running
⏱ 60 seconds
Last run: 01/18/2026, 09:31:09

Complete Correlations
Links Postfix logs to messages

running
⏱ 120 seconds (2 minutes)
📋 Pending: 0
Last run: 01/18/2026, 09:31:09

Update Final Status
Updates final status for correlations with late-arriving Postfix logs

running
⏱ 120 seconds (2 minutes)
⏳ Max: 10 minutes
📋 Pending: 0
Last run: 01/18/2026, 09:31:09

Expire Correlations
Marks old incomplete correlations as expired

running
⏱ 60 seconds (1 minute)
⏱ Expire: 10 minutes
Last run: 01/18/2026, 09:31:09

Cleanup Logs
Removes old logs based on retention period

idle
📅 Daily at 2 AM
🗂 30 days
Check App Version
Checks for application updates from GitHub

success
⏱ 6 hours
Last run: 01/18/2026, 07:45:09

DNS Check (All Domains)
Validates DNS records (SPF, DKIM, DMARC) for all active domains

failed
⏱ 6 hours
Last run: 01/18/2026, 07:46:13

RetryError[<Future at 0x76c06a748c10 state=finished raised MailcowAPIError>]

Sync Active Domains
Syncs active domains list from Mailcow API

failed
⏱ 6 hours
Last run: 01/18/2026, 07:45:13

cannot access local variable 'e' where it is not associated with a value

DMARC IMAP Import
Imports DMARC reports from IMAP mailbox

success
⏱ 3600 seconds (60 minutes)
Last run: 01/18/2026, 08:45:10

Update MaxMind Databases
Updates MaxMind GeoIP databases (City & ASN)

success
📅 Weekly (Sunday 3 AM)
Last run: 01/18/2026, 07:46:09

I need a better way to display this.
Edit:
Just noticed this in the log.
Do I need to create a new API key?
netfilter-mailcow-1 | Address 47.200.44.183/32 is whitelisted by rule 47.200.44.183/32
netfilter-mailcow-1 | 47.200.44.183 matched rule id 1 (mailcow UI: Invalid password for API_USER by 47.200.44.183)
I think I fixed it.
I added the new public IP to the read only access in the API config.

bpsintl

I am trying to set up the new Maxmind bits in v2, but when I add this to the .env file:

services:
app:
volumes:
- ./data:/app/data

And try and run docker compose up -d, I get an error saying bad character in variable name

accolon

bpsintl when I add this to the .env file

You must add the lines to the docker-compose.yml, like this:
ShlomiPorush/mailcow-logs-viewerblob/43a51d5848fba860edf0295e8610e6e8179b87ca/docker-compose.yml#L31

bpsintl

accolon Yeah I realised that just after I posted that message. How can I tell Maxmind is working properly?

Cisco30

bpsintl
If Maxmind is working, the countries and flags from which the email was sent will be displayed.

shlomi

bpsintl
In settings page check for MaxMind Status

bpsintl

Hmm, mine is not displaying the flags or countries. When I look at the status tab, I can see at the bottom it says success next to update maxmind database though…..

shlomi

bpsintl
Also, location info are not updated for older logs, but from here on out.

bpsintl

shlomi I fixed it, I may have had the volumes bit in the wrong location in the docker yml file

Cisco30

I simply configured this in .env

# =============================================================================
# MAXMIND (Optional)
# =============================================================================

MAXMIND_ACCOUNT_ID=7258XX
MAXMIND_LICENSE_KEY=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

bpsintl

shlomi Strangely, the flag and country only worked for 1 inbound message (marked as spam) from Russia. All the other messages since I setup Maxmind have no country or flag showing

CK_beats

At my configuration there is no flag of the country visible.
But Maxmind IP is setted up correctly.
Database was downloaded at service startup.

bpsintl

CK_beats Mine is exactly the same

« Previous Page Next Page »