Skip to content

Commit c2848b4

Browse files
02-basic-email-system.md (#1936)
Grammar check
1 parent 46337b0 commit c2848b4

File tree

1 file changed

+20
-20
lines changed

1 file changed

+20
-20
lines changed

docs/guides/email/02-basic-email-system.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ contributors: Ganna Zhyrnova, Neel Chauhan
66

77
# Overview
88

9-
This document aims to provide the reader with a detailed understanding of the various components of an email system, including the installation and basic configuration of one.
9+
This document aims to provide the reader with a detailed understanding of the various components of an email system, including its installation and basic configuration.
1010

1111
All commands in this document are executed using **root(uid=0)**.
1212

@@ -20,7 +20,7 @@ All commands in this document are executed using **root(uid=0)**.
2020

2121
!!! info
2222

23-
Without a database, Postfix and Dovecot can still work for a small installation.
23+
Postfix and Dovecot can still work for a small installation without a database.
2424

2525
### Install and configure `bind`
2626

@@ -62,7 +62,7 @@ zone "rockylinux.me" IN {
6262

6363
!!! question
6464

65-
**What is a DNS zone?** A DNS zone is aportion of the DNS namespace that's hosted on a DNS server. A DNS zone contains resource records, and a DNS server responds to queries for records in that namespace. A DNS server can have multiple DNS zones. Simply put, a DNS zone is analogous to a book catalog.
65+
**What is a DNS zone?** A DNS zone is a portion of the DNS namespace hosted on a DNS server. A DNS zone contains resource records, and a DNS server responds to queries for records in that namespace. A DNS server can have multiple DNS zones. Simply put, a DNS zone is analogous to a book catalog.
6666

6767
First, initialize BIND:
6868

@@ -120,7 +120,7 @@ dns.rockylinux.me. 86400 IN A 192.168.100.7
120120

121121
### Install and configure MySQL
122122

123-
First, lets now install MySQL from source:
123+
First, install MySQL from the source:
124124

125125
```bash
126126
Shell(192.168.100.5) > groupadd mysql && useradd -r -g mysql -s /sbin/nologin mysql
@@ -142,7 +142,7 @@ Shell(192.168.100.5) > cd /usr/local/src/mysql-8.0.33 && mkdir build && cd build
142142
&& make && make install
143143
```
144144

145-
Next, lets initialize MySQL:
145+
Next, let's initialize MySQL:
146146

147147
```bash
148148
Shell(192.168.100.5) > chown -R mysql:mysql /usr/local/mysql
@@ -178,7 +178,7 @@ Shell(192.168.100.5) > /usr/local/mysql/bin/mysqld_safe --user=mysql &
178178
Shell(192.168.100.5) > /usr/local/mysql/bin/mysql -u root --password="pkqaXRuTn1/N"
179179
```
180180

181-
Then, lets add our domain entries in MySQL:
181+
Then, let's add our domain entries in MySQL:
182182

183183
```sql
184184
Mysql > ALTER USER 'root'@'localhost' IDENTIFIED BY 'rockylinux.me';
@@ -194,7 +194,7 @@ Mysql > grant all privileges on *.* to 'mailrl'@'%' with grant option;
194194

195195
#### Create tables and insert data
196196

197-
Lets now create the MySQL tables required for Dovecot:
197+
Let's now create the MySQL tables required for Dovecot:
198198

199199
```sql
200200
Shell(192.168.100.5) > /usr/local/mysql/bin/mysql -u mailrl --password="mail.rockylinux.me"
@@ -231,7 +231,7 @@ Mysql > insert into virtual_aliases(id,domain_id,source,destination) values(1,1,
231231
Mysql > insert into virtual_aliases(id,domain_id,source,destination) values(2,1,'all@mail.rockylinux.me','leeo@mail.rockylinux.me');
232232
```
233233

234-
The password entries for the relevant email users are not shown here, as it requires the use of `doveadm pw -s SHA512-crypt -p twotestandtwo` command. See [here](#ap1)
234+
The password entries for the relevant email users are not shown here, as it requires using `doveadm pw -s SHA512-crypt -p twotestandtwo` command. See [here](#ap1)
235235

236236
#### Knowledge of SHA512 (SHA-2)
237237

@@ -294,7 +294,7 @@ You need to know these binary executable files:
294294

295295
!!! tip
296296

297-
You can specify the default MTA using the `alternatives -config mta` command if you have more than one MTA on your server.
297+
If your server has more than one MTA, you can specify the default MTA using the `alternatives -config mta` command.
298298

299299
#### Explanation of the /etc/postfix/main.cf file
300300

@@ -336,21 +336,21 @@ meta_directory = /etc/postfix
336336
shlib_directory = /usr/lib64/postfix
337337
```
338338

339-
The explanation of these parameters are:
339+
The explanation of these parameters is as follows:
340340

341-
* `compatibility_level = 2`: Enable compatibility with Postfix 2.x configurations.
341+
* `compatibility_level = 2`: Enables compatibility with Postfix 2.x configurations.
342342
* `data_directory = /var/lib/postfix`. The Postfix cache directory.
343343
* `myhostname = host.domain.tld`: **Important:** You need to change it to the hostname under your domain name.
344344
* `mydomain = domain.tld`: **Important:** You need to change it to your domain name.
345345
* `myorigin = $myhostname` and `myorigin = $mydomain`: **Important:** parameters that have been commented out. The main function is to complement the sender's mail suffix. `$` represents a reference parameter variable.
346346
* `inet_interfaces = localhost`: The interfaces to listen to. This value is usually changed to "all".
347-
* `inet_protocols = all`: Enable IPv4, and IPv6 if an address is found.
347+
* `inet_protocols = all`: Enables IPv4, and IPv6 if an address is found.
348348
* `mydestination = \$myhostname, localhost.\$mydomain, localhost`: Indicates the mail server's destination hosts.
349349
* `unknown_local_recipient_reject_code = 550`: The error code returned when receiving an email to an unknown destination or rejecting an email.
350-
* `mynetworks =`: Set which networks we should accept emails from.
351-
* `relay_domains = $mydestination`: Set which domains we should relay emails from.
350+
* `mynetworks =`: Sets which networks we should accept emails from.
351+
* `relay_domains = $mydestination`: Sets which domains we should relay emails from.
352352
* `alias_maps = hash:/etc/aliases`: List of our email server's aliases.
353-
* `alias_database = hash:/etc/aliases`: The database to be used by aliases.
353+
* `alias_database = hash:/etc/aliases`: The database is to be used by aliases.
354354
* `home_mailbox = Maildir/`: **Important**: Out local mailbox location.
355355
* `debug_peer_level = 2`: Level of log records.
356356
* `setgid_group = postdrop`: The Unix group for managing Postfix queues.
@@ -584,8 +584,8 @@ The file description is as follows:
584584
* `dovecot.conf` is the main Dovecot configuration file.
585585

586586
* Load other configuration files via `!include conf.d/*.conf`.
587-
* The numeral prefix of the sub configuration file is to facilitate human understanding of its parsing order.
588-
* Due to historical reasons, some config files are still separate, which are typically named `*.conf.ext`.
587+
* The numeral prefix of the sub-configuration file facilitates human understanding of its parsing order.
588+
* Due to historical reasons, some config files are still separate, typically named `*.conf.ext`.
589589
* In the configuration file, you can use variables divided into **Global variables** and **User variables**, starting with `%`. See [here](https://doc.dovecot.org/configuration_manual/config_file/config_variables/#config-variables).
590590

591591
* `10-auth.conf`: Authentication configuration.
@@ -598,12 +598,12 @@ The file description is as follows:
598598
#### Some important configuration file parameters
599599

600600
* `protocols = imap pop3 lmtp submission`: List of protocols to be used.
601-
* `listen = *, ::`: A comma separated list of IPs or hosts where to listen in for connections. `*` listens in all IPv4 interfaces, `::` listens in all IPv6 interfaces.
601+
* `listen = *, ::`: A comma-separated list of IPs or hosts where to listen in for connections. `*` listens in all IPv4 interfaces, `::` listens in all IPv6 interfaces.
602602
* `disable_plaintext_auth = yes`: Whether to turn off plaintext authentication.
603603
* `auth_mechanisms = `: The type of authentication mechanism to be used. Multiple values can be specified and separated by spaces. Values: plain, login, digest-md5, cram-md5, ntlm, rpa, apop, anonymous, gssapi, otp, skey, gss-spnego.
604604
* `login_trusted_networks= `: Which IP networks are allowed to use Dovecot. It can be a single IP address, a network segment, or both. As an example: `login_trusted_networks = 10.1.1.0/24 192.168.100.2`
605605
* `mail_location = `: For an empty value, Dovecot attempts to find the mailboxes automatically (looking at `~/Maildir`, `/var/mail/username`, `~/mail`, and `~/Mail`, in that order). However, auto-detection commonly fails for users whose mail directory hasn’t yet been created, so you should explicitly state the full location here, if possible.
606-
* `mail_privileged_group = `: This group is enabled temporarily for privileged operations. Currently, this is used only with the INBOX when either its initial creation or dotlocking fails. Typically, this is set to `mail` to access `/var/mail`.
606+
* `mail_privileged_group = `: This group is enabled temporarily for privileged operations. This is used only with the INBOX when its initial creation or dotlocking fails. Typically, this is set to `mail` to access `/var/mail`.
607607

608608
#### Modify multiple files
609609

@@ -661,7 +661,7 @@ userdb {
661661

662662
!!! warning
663663

664-
Don't write the above grammar on one line, such as this: `userdb {driver = sql args = uid=vmail gid=vmail home=/var/mail/vhosts/%d/%n}`. Otherwise, it won't work.
664+
Don't write the above grammar in one line, such as `userdb {driver = sql args = uid=vmail gid=vmail home=/var/mail/vhosts/%d/%n}`. Otherwise, it won't work.
665665

666666
Edit the `/etc/dovecot/dovecot-sql.conf.ext` file with the following contents:
667667

0 commit comments

Comments
 (0)