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...

DocFraggle

Ganzjahresgriller For now, edit your docker-compose file and change the line back from

- "8080:8080"
to
- "${APP_PORT:-8080}:8080"

shlomi

DocFraggle
when we moved to configure settings through the app and to avoid confusion, (there is really no point of setting a port from within the app), so I removed it.

But like any container, you can map any port in the docker-compose.yml file

DocFraggle

shlomi But like any container, you can map any port in the docker-compose.yml file

Sure, but that requires the user to either change the docker-compose.yaml file directly (which will lead to conflicts in the future) or use a docker-compose.override.yaml (which requires “deeper” knowledge of the user).
As the .env file is still there and in use, why not set the APP_PORT variable there and use

"${APP_PORT:-8080}:8080"

for the app block? That would make things much easier for the end user imho

shlomi

DocFraggle
Fair point regarding convenience. However, the current setup already gives users the freedom to map the host port to whatever they prefer (e.g., XXXX:8080).

The actual limitation is on the application side—the internal port is fixed and cannot be changed within the app itself. Since the host-side mapping is already fully customizable via standard Docker syntax, adding a dedicated .env variable might be an extra layer we don’t strictly need, as users can already point any port they like to the internal 8080.

for example:

    ports:
      - "8082:8080"

DocFraggle

shlomi Yes, if they manually edit your Git controlled docker-compose.yaml 🙂 If you change something in this file in one of the next releases users with modified docker-compose.yaml files will need to manually merge the file to their setup due to this error:

error: Your local changes to the following files would be overwritten by merge:
        docker-compose.yaml
Please commit your changes or stash them before you merge.
Aborting

Using APP_PORT in the .env file and "${APP_PORT:-8080}:8080" in your docker-compose.yaml would fix that.
Users could also create a docker-compose.override.yaml file, but they need to know how to do that

just my two cents 😉

shlomi

DocFraggle
docker-compose.yml its not git controlled

shlomi

@timber
Done ✅

timber

shlomi Amazing!

maybl8

After reading all of the about APP Port . Mine is not working now.
I need to use a different port other that 8080. I have something else on 8080.
What do I need to put where in what file?

Ganzjahresgriller

In docker-compose.yml:

ports:

"${APP_PORT:-8080}:8080

In .env

APP_PORT=<your Portnumber>

maybl8

One more clarification.
The dokercopose for the mailcow log viewer not mailcow itself?

Ganzjahresgriller

log Viewer

CK_beats

Of course, I find the new functions incredibly well implemented and extensive!

I still have a question about the new “Quarantine” function:
Does “delete” really mean “delete” or “learn as SPAM and delete”?

Both functions are available in Mailcow’s original Quarantine folder.
If it “just” means deleting it, it would be great if the “learn and delete as SPAM” function was added at some point.

maybl8

Well that is what I have and it’s not coming up.
I did update to versiion 2.50 . Maybe something else needs done.

compose up and down wasn’t enough.
Restarted the server
All working now.
Edit:
Added the setting:
SETTINGS_EDIT_VIA_UI_ENABLED=true
Not not loading again.
I don’t get it.

Edit number 2:
Ok I changed crowdsec to be on port :8081 and put the log viewer back on 8080.
Still not working so it must be some other issue.

maybl8

maybl8
Do you see anything wrong here:

[root@mail mailcow-dockerized]# sudo ss -tlnp
State       Recv-Q       Send-Q                           Local Address:Port              Peer Address:Port      Process
LISTEN      0            4096                                 127.0.0.1:6060                   0.0.0.0:*          users:(("crowdsec",pid=6644,fd=23))
LISTEN      0            4096                                   0.0.0.0:9099                   0.0.0.0:*          users:(("docker-proxy",pid=2821,fd=7))
LISTEN      0            4096                             100.85.253.81:52187                  0.0.0.0:*          users:(("tailscaled",pid=554,fd=21))
LISTEN      0            4096                                 127.0.0.1:7654                   0.0.0.0:*          users:(("docker-proxy",pid=4156,fd=7))
LISTEN      0            4096                                 127.0.0.1:8081                   0.0.0.0:*          users:(("crowdsec",pid=6644,fd=15))
LISTEN      0            4096                                 127.0.0.1:19991                  0.0.0.0:*          users:(("docker-proxy",pid=4382,fd=7))
LISTEN      0            4096                                 127.0.0.1:45157                  0.0.0.0:*          users:(("containerd",pid=561,fd=15))
LISTEN      0            4096                                 127.0.0.1:13306                  0.0.0.0:*          users:(("docker-proxy",pid=4488,fd=7))
LISTEN      0            4096                                   0.0.0.0:143                    0.0.0.0:*          users:(("docker-proxy",pid=4295,fd=7))
LISTEN      0            4096                                   0.0.0.0:80                     0.0.0.0:*          users:(("docker-proxy",pid=3485,fd=7))
LISTEN      0            4096                                   0.0.0.0:110                    0.0.0.0:*          users:(("docker-proxy",pid=4275,fd=7))
LISTEN      0            4096                                   0.0.0.0:25                     0.0.0.0:*          users:(("docker-proxy",pid=3664,fd=7))
LISTEN      0            4096                                   0.0.0.0:465                    0.0.0.0:*          users:(("docker-proxy",pid=3685,fd=7))
LISTEN      0            4096                                   0.0.0.0:443                    0.0.0.0:*          users:(("docker-proxy",pid=3508,fd=7))
LISTEN      0            4096                                   0.0.0.0:587                    0.0.0.0:*          users:(("docker-proxy",pid=3706,fd=7))
LISTEN      0            4096                                   0.0.0.0:993                    0.0.0.0:*          users:(("docker-proxy",pid=4315,fd=7))
LISTEN      0            4096                                   0.0.0.0:995                    0.0.0.0:*          users:(("docker-proxy",pid=4337,fd=7))
LISTEN      0            128                                    0.0.0.0:2222                   0.0.0.0:*          users:(("sshd",pid=548,fd=6))
LISTEN      0            4096                                   0.0.0.0:4190                   0.0.0.0:*          users:(("docker-proxy",pid=4357,fd=7))
LISTEN      0            4096                                   0.0.0.0:8080                   0.0.0.0:*          users:(("docker-proxy",pid=4245,fd=7))
LISTEN      0            4096                                      [::]:9099                      [::]:*          users:(("docker-proxy",pid=2844,fd=7))
LISTEN      0            4096                                         *:9090                         *:*          users:(("systemd",pid=1,fd=84))
LISTEN      0            4096                                      [::]:143                       [::]:*          users:(("docker-proxy",pid=4301,fd=7))
LISTEN      0            4096                                      [::]:80                        [::]:*          users:(("docker-proxy",pid=3493,fd=7))
LISTEN      0            4096                                      [::]:110                       [::]:*          users:(("docker-proxy",pid=4281,fd=7))
LISTEN      0            4096                                      [::]:25                        [::]:*          users:(("docker-proxy",pid=3669,fd=7))
LISTEN      0            4096                                      [::]:465                       [::]:*          users:(("docker-proxy",pid=3691,fd=7))
LISTEN      0            4096                                      [::]:443                       [::]:*          users:(("docker-proxy",pid=3515,fd=7))
LISTEN      0            4096                                      [::]:587                       [::]:*          users:(("docker-proxy",pid=3712,fd=7))
LISTEN      0            4096                                      [::]:993                       [::]:*          users:(("docker-proxy",pid=4320,fd=7))
LISTEN      0            4096                                      [::]:995                       [::]:*          users:(("docker-proxy",pid=4342,fd=7))
LISTEN      0            128                                       [::]:2222                      [::]:*          users:(("sshd",pid=548,fd=7))
LISTEN      0            4096                                         *:3000                         *:*          users:(("grafana",pid=547,fd=24))
LISTEN      0            4096               [fd7a:115c:a1e0::2101:fd51]:52663                     [::]:*          users:(("tailscaled",pid=554,fd=23))
LISTEN      0            4096                                      [::]:4190                      [::]:*          users:(("docker-proxy",pid=4363,fd=7))
LISTEN      0            4096                                      [::]:8080                      [::]:*          users:(("docker-proxy",pid=4251,fd=7))

edit

[root@mail mailcow-logs-viewer]# docker logs mailcow-logs-app
INFO:     Started server process [1]
INFO:     Waiting for application startup.

Edit 2
Looks like I am unhealthy for some reason

demo@mail opt]$ sudo docker ps
CONTAINER ID   IMAGE                                             COMMAND                  CREATED          STATUS                      PORTS                                                                                                                                                                                                                                         NAMES
578f0bb4f325   ghcr.io/shlomiporush/mailcow-logs-viewer:latest   "./entrypoint.sh"        19 minutes ago   Up 19 minutes (unhealthy)   0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp                                                                                                                                                                                                   mailcow-logs-app

« Previous Page