Quickstart: send wiki mail over SMTP

The shortest way from “the plugin is installed” to “a test message is in the inbox”. Four steps, about fifteen minutes.

Prerequisites

wkmail is installed and enabled in the Extension Manager.
You are signed in as superuser.
A mailbox you may submit through — your own server or a provider account — and its password.
The submission port is reachable from this server, commonly 587 or 465. Hosted environments often block it; step 3 measures that before you start doubting the configuration.

While transport is default, DokuWiki keeps sending through PHP mail(). You can therefore prepare the whole configuration without endangering the wiki's existing mail — only step 4 switches over.

Step 1: enter the credentials

Admin → Configuration, section wkmail — or from the administration screen via Open settings (host, mailbox, password) →.

For a known provider pick its profile; host, port and encryption are then set for you. For your own server choose custom and enter:

Setting	Meaning
`host`	The submission host. Not necessarily the same name as the MX record.
`port`	587 for STARTTLS, 465 for implicit TLS.
`encryption`	`tls` for STARTTLS, `ssl` for implicit TLS, `none` for plaintext.
`username`	The mailbox you authenticate as.
`password`	The password — or better a reference, see below.

Use encryption = none only against a server on the same host. On anything else the password crosses the network in the clear.

With wkvault installed you enter a reference instead of the password, for example vault:mail-smtp. The credential then lives in one place with an access record, rather than in this plugin's configuration.

Step 2: open the administration screen

Admin → Mail transport, directly /doku.php?do=admin&page=wkmail.

The screen runs the checks; the values themselves live in the configuration manager.

Step 3: measure whether the port is open

Under Current transport choose Measure now. The answer appears in the Port reachable row.

The same from the command line, on the machine that will send:

php bin/plugin.php wkmail probe

php bin/plugin.php wkmail status

probe measures now, status shows the last stored verdict without measuring. A closed port is the failure that arrives as “the code never came” and leaves nothing else to see.

Step 4: switch over and send a test

Set transport to smtp. Then, under Test message, enter your own address in Send to and choose Send test message.

Check the result

The screen reports Message accepted for delivery to ….
The message is in the inbox, not the spam folder.
The Deliverability section reads ok — it reads the actual DNS records of your sender domain and says what SPF, DMARC and the return path currently assert.

An accepted submission only proves the submission server took the message. Whether it reaches an inbox is decided by the checks under Deliverability.

Next step

wkvault — store the password as a reference instead of a value.
wkidentity — the flows that depend on mail arriving, and the command-line way through when it does not.
wkmail (German) — the package page: every setting, and what sender alignment does to From and Reply-To.