mirror of
https://github.com/foxcpp/maddy.git
synced 2025-04-06 06:27:38 +03:00
docs: Improve setting-up tutorial
This commit is contained in:
parent
21aad91071
commit
43d494e70a
1 changed files with 35 additions and 5 deletions
|
@ -22,7 +22,9 @@ there are a few things to keep in mind:
|
||||||
- Make sure your provider does not block SMTP traffic (25 TCP port). Most VPS
|
- Make sure your provider does not block SMTP traffic (25 TCP port). Most VPS
|
||||||
providers don't do it, but some "cloud" providers (such as Google Cloud) do
|
providers don't do it, but some "cloud" providers (such as Google Cloud) do
|
||||||
it, so you can't host your mail there.
|
it, so you can't host your mail there.
|
||||||
- ...
|
|
||||||
|
- It is recommended to run your own DNS resolver with DNSSEC verification
|
||||||
|
enabled.
|
||||||
|
|
||||||
## Installing maddy
|
## Installing maddy
|
||||||
|
|
||||||
|
@ -33,8 +35,11 @@ Your options are:
|
||||||
Available on [GitHub](https://github.com/foxcpp/maddy/releases) or
|
Available on [GitHub](https://github.com/foxcpp/maddy/releases) or
|
||||||
[maddy.email](https://maddy.email/).
|
[maddy.email](https://maddy.email/).
|
||||||
|
|
||||||
The tarball contains the full filesystem tree so you can directly
|
The tarball includes maddy and maddyctl executables you can
|
||||||
extract it into root directory (or you can take just executable).
|
copy into /usr/local/bin as well as systemd unit file you can
|
||||||
|
use on systemd-based distributions for automatic startup and service
|
||||||
|
supervision. You should also create "maddy" user and group.
|
||||||
|
See below for more detailed instructions.
|
||||||
|
|
||||||
* Docker image (Linux, amd64)
|
* Docker image (Linux, amd64)
|
||||||
|
|
||||||
|
@ -49,6 +54,32 @@ Your options are:
|
||||||
|
|
||||||
See [here](../building-from-source) for instructions.
|
See [here](../building-from-source) for instructions.
|
||||||
|
|
||||||
|
* Arch Linux packages
|
||||||
|
|
||||||
|
For Arch Linux users, `maddy` and `maddy-git` PKGBUILDs are available
|
||||||
|
in AUR. Additionally, binary packages are available in 3rd-party
|
||||||
|
repository at https://foxcpp.dev/archlinux/
|
||||||
|
|
||||||
|
## System configuration (systemd-based distribution)
|
||||||
|
|
||||||
|
If you built maddy from source and used `./build.sh install` then
|
||||||
|
systemd unit files should be already installed. If you used
|
||||||
|
a pre-built tarball - copy `systemd/*.service` to /etc/systemd/system
|
||||||
|
manually.
|
||||||
|
|
||||||
|
You need to reload service manager configuration to service available:
|
||||||
|
|
||||||
|
```
|
||||||
|
systemctl daemon-reload
|
||||||
|
```
|
||||||
|
|
||||||
|
Additionally, you should create maddy user and group. Unlike most other
|
||||||
|
Linux mail servers, maddy never runs as root.
|
||||||
|
|
||||||
|
```
|
||||||
|
useradd -mrU -s /sbin/nologin -d /var/lib/maddy -c "maddy mail server" maddy
|
||||||
|
```
|
||||||
|
|
||||||
## Host name + domain
|
## Host name + domain
|
||||||
|
|
||||||
Open /etc/maddy/maddy.conf with vim^W your favorite editor and change
|
Open /etc/maddy/maddy.conf with vim^W your favorite editor and change
|
||||||
|
@ -113,11 +144,10 @@ acme.sh --force --install-cert -d mx1.example.org \
|
||||||
## First run
|
## First run
|
||||||
|
|
||||||
```
|
```
|
||||||
systemctl daemon-reload
|
|
||||||
systemctl start maddy
|
systemctl start maddy
|
||||||
```
|
```
|
||||||
|
|
||||||
Well, it should be running now, except that it is useless because we haven't
|
The daemon should be running now, except that it is useless because we haven't
|
||||||
configured DNS records.
|
configured DNS records.
|
||||||
|
|
||||||
## DNS records
|
## DNS records
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue