The KumoMTA team answers a metric tonne of questions every week about open-source software, the KumoMTA code, and our favourite 3D printer hacks. A large number of those questions are often about where people can find a tutorial or guide to help them install KumoMTA. This post is here to answer the question: "Where is the elusive KumoMTA tutorial?"
Well, it turns out that the search was not that hard, even though it is one of the most asked questions. Two years ago, when we set out to create the most performant MTA in the world, we knew that documentation was going to be critical, so we invested many hours crafting detailed instructions, code references, and ... yes... a tutorial.
If you are looking for the "official" tutorial, you need only open our documentation at https://docs.kumomta.com/, and you will find that the very first word on the toolbar is "tutorial". Clicking through that will take you directly to a quickstart tutorial along with a handy video guide. That will get you a basic install for some rough testing, but it is far from production quality.
Proceed down the list of pages in that section. You will find a deeper discussion about tuning your server environment, operating system selection, platform considerations, as well as suggestions for CPU count, RAM considerations and storage volume sizing. This is followed by the specific instructions for installation, configuration and tuning.
Finally, we discuss several methods of testing and where to look for logs and diagnostic output. If you continue through "Next Steps," there is direction to check out the more complex Installation, Configuration, Operation, and Advanced Policies sections of the user guide.
Outside of the Reference Manual, our documentation is really ALL written from the perspective of guiding a user through the installation and configuration of KumoMTA.
In addition to the official documentation, there is also a two-minute AWS install video on our YouTube channel that shows a full install from instance selection to basic testing. Also, on that YouTube channel, you will find a more substantial 20-minute video explaining how to use the Policy Helpers.
A few of our users have also written their own tutorials to follow:
- HTDOCS.dev has a great tutorial here https://htdocs.dev/posts/kumomta-setup/
- There is also a detailed walkthrough on Marat's Notes
- Most recently, EmailConsul posted this tutorial
And one of our long-time supporters also kindly indexed our docs on DeepWiki, so you can now ask "Devin" interesting questions like "How do I assign an IP address to a message"?
There is no shortage of useful tutorials and guides for getting KumoMTA installed and configured, but we are always open to helping our users get more value, so if you have suggestions for something different, please let us know.
------------------------------------------------------------------
KumoMTA is the first open-source MTA designed from the ground up for the world's largest commercial senders.
We are fueled by Professional Services and Sponsorship revenue.
Join the Discord | Review the Docs | Read the Blog | Grab the Code | Support the team