prometheus / prometheus/alertmanager

Document that smtp_smarthost does not support port 465

Open
#4,507 6 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

kind/support
Dominant language
Go
Stars
8.6k
Forks
2.5k
Avg merge
2d 6h
Merged PRs (30d)
61

Description

The Alertmanager documentation for setting smtp_smarthost should state that port 465 is not supported, as explained here:

https://stackoverflow.com/questions/63557145/alertmanager-not-able-send-mails-via-port-465

This has caused me some unnecessary head scratching. After all, that issue has been known for years.

Sending e-mails over port 465 is very common. I have been using it for a long time without any issue, the first problem I ever had was actually with Prometheus' Alertmanager.

Some big providers recommend port 465, for example:

https://www.cloudflare.com/learning/email-security/smtp-port-25-587/

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Alertmanager configuration documentation linked in the issue and find the smtp_smarthost setting. Add a note stating that port 465 is unsupported, using the linked references for context. Done means the limitation is clearly visible in the smtp_smarthost documentation.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.