Commit Graph
239 Commits
Author SHA1 Message Date
Tom Mairs a0a63a2edc refining tuorial pages 2023-03-22 06:35:33 +00:00
Tom Mairs 298f9db7f2 rearrange docs to make more sense 2023-03-21 23:40:47 +00:00
Wez Furlong 6c4e3915b8 fixup example config to match default install 2023-03-20 14:14:15 -07:00
Tom Mairs 37f56fb15b Rearrange Pages to make more sense 2023-03-17 05:56:14 +00:00
Tom Mairs fc6f3537d6 Updates to Day 1 doc 2023-03-17 05:45:52 +00:00
Tom Mairs 4530a3a3e4 adding a TL;DR section to the Day1 doc 2023-03-16 23:43:50 +00:00
Mike Hillyer d9eb21c6e0 And had a comma where I shouldn't... 2023-03-16 14:26:07 -04:00
Mike Hillyer 554e8baff9 Forgot a comma. 2023-03-16 14:24:03 -04:00
Mike Hillyer b2a7ceb3a3 Add IPv6 to example config, moved example spool and logs to /var/spool and /var/log from /var/tmp. 2023-03-16 14:22:31 -04:00
Wez Furlong f9c6eb8ce3 add ed25519 dkim signer 2023-03-16 10:23:54 -07:00
Mike Hillyer bb0ce4f8ab Update concepts page. 2023-03-15 17:32:18 -04:00
Wez Furlong f1be7bb114 docs: tweak example config 2023-03-15 14:28:00 -07:00
Mike Hillyer 51e329890d Automated doc formatting fix 2023-03-15 21:06:36 +00:00
Mike Hillyer 52274ebf5f Tom gets a warning, I get an error, TANJ! 2023-03-15 17:05:44 -04:00
Mike Hillyer 8dfef6a0df Fix lua in example, fix link in concepts. 2023-03-15 17:00:20 -04:00
Mike Hillyer fdaaf65708 Updating the example config with Wez's latest spool and queue settings. 2023-03-15 16:51:55 -04:00
Wez Furlong 09a251d5a1 docs: adjust queue example to show composing domain and source params 2023-03-15 10:13:56 -07:00
Wez Furlong b43e88985c add kumo.dns.lookup_mx
This function returns MX information, including the computed site_name.
Update the queue example to show how to use it to populate the SITE_OF
map used in that example.

This commit switches to using the `Name` type under the covers to ensure
that we use canonical names for our cache keys.
2023-03-15 09:34:23 -07:00
Mike Hillyer 0e909f3407 Add EHLO to the example config 2023-03-15 11:43:13 -04:00
Tom Mairs 437aef4b5a Update kumomta_day_1.md 2023-03-15 00:05:39 -06:00
Tom Mairs 495fe5b48a update Day-1 doc 2023-03-15 05:55:45 +00:00
Wez Furlong 8cf8857a1c docs: revise config concepts intro
Wordsmith it to play to the strengths of the config
2023-03-14 22:46:09 -07:00
Wez Furlong be0fd76d0b add ehlo_domain config option 2023-03-14 22:26:07 -07:00
Wez Furlong a7884f01b4 fixup markdown for bug reporting page
I think a lot of the content on here can be subsumed by the
issue template and pruned from this page.

But this commit is just about making it not render as a wall
of text in mkdocs.
2023-03-14 22:17:18 -07:00
Wez Furlong 1dd39c3043 docs: console-ify the tutorial section
It looks more conventional this way.
I switched a few sysadmin sections away from `sudo -s` to
non-privileged commands that use sudo; most of those were to
deal with `sudo echo > file` not being able to write to `file` as root.

Those are replaced by `echo | sudo tee file >/dev/null` which allows
running only the file writing part as root.
2023-03-14 20:26:03 -07:00
Wez Furlong eec9b5ad77 update docker for new default policy file location 2023-03-14 20:16:13 -07:00
Wez Furlong bcdef3fd65 unbreak doc build 2023-03-14 20:07:40 -07:00
Wez Furlong e1f0939d81 add json functions 2023-03-14 20:07:40 -07:00
Mike Hillyer 7747bf5633 Automated doc formatting fix 2023-03-15 02:47:29 +00:00
Mike Hillyer 426b26744f Fix broken links. 2023-03-14 22:46:42 -04:00
Mike Hillyer ce93b51da8 More treaks to the concepts page, start the policy chapter skeleton. 2023-03-14 22:42:14 -04:00
Mike Hillyer a3978b8677 Automated doc formatting fix 2023-03-15 02:22:04 +00:00
Mike Hillyer 0c5d7c9f90 Got another one backwards. 2023-03-14 22:20:54 -04:00
Mike Hillyer 339f812608 Got that backwards, lua fix. 2023-03-14 22:17:59 -04:00
Mike Hillyer 9d7063e3ab Updating the example config, adding configuration concepts. 2023-03-14 22:13:41 -04:00
Wez Furlong 384da92c0e docs: update dkim signing to use header from 2023-03-14 18:53:47 -07:00
Wez Furlong b3f3f877df add functions for working with address headers 2023-03-14 18:53:47 -07:00
Tom Mairs 91c41c3cd5 added KumoMTA Day 1 tutorial 2023-03-14 23:21:26 +00:00
Tom Mairs 16c0a44141 Fixing a spelling mistake 2023-03-14 23:21:26 +00:00
Mike Hillyer ed4ae9597e Automated doc formatting fix 2023-03-14 23:13:37 +00:00
Mike Hillyer af04bd7ce0 Update time notation and example script. 2023-03-14 19:12:46 -04:00
Wez Furlong 4d74bd58e4 docs: adjust example config
Simply a bit by removing some defaults, and remove some dangerous/bad
settings from my local test that should not be in the example config.

Factor out the dkim config table so that it is computed once, rather
than on every call to the event handler.
2023-03-14 13:52:30 -07:00
Mike Hillyer 331a46d8db Automated doc formatting fix 2023-03-14 20:09:36 +00:00
Mike Hillyer deab6adb40 Change toml file path to new /opt/kumomta/etc path style. 2023-03-14 16:08:42 -04:00
Mike Hillyer a074e9ec02 Automated doc formatting fix 2023-03-14 20:01:13 +00:00
Mike Hillyer 475b661712 Fixing Lua parse error in example policy. 2023-03-14 16:00:28 -04:00
Mike Hillyer fe9d51f289 Adding Wez's example of dynamic DKIM key path signing across both ingress routes (SMTP/API). 2023-03-14 15:56:39 -04:00
Mike Hillyer 5980d42375 Working on the example policy. 2023-03-14 15:31:02 -04:00
Wez Furlong a3d4c49ef1 docs: avoid copying $ prefixes from console code blocks
Rather than using `bash` for the mix of shell and output,
use `console`. That will cause the text to be marked up so
that the `$` prompt stuff won't get selected by dragging.

Enable copy button to copy the whole block, and add some
js to filter out the the $ and # prefixes from that content.
2023-03-14 10:17:55 -07:00
Wez Furlong 4c71090669 docs: standardize the header before the generated list of functions 2023-03-14 10:17:55 -07:00