SPF and reorg

This commit is contained in:
Jeff Moe 2024-09-01 15:52:11 -06:00
parent 832c6499ee
commit 91ee18ccc7
2 changed files with 380 additions and 355 deletions

View file

@ -9,7 +9,7 @@ msgid ""
msgstr "" msgstr ""
"Project-Id-Version: Libre Developers Documentation 0\n" "Project-Id-Version: Libre Developers Documentation 0\n"
"Report-Msgid-Bugs-To: \n" "Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-09-01 15:42-0600\n" "POT-Creation-Date: 2024-09-01 15:51-0600\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: en\n" "Language: en\n"
@ -34,538 +34,552 @@ msgid ""
"up a web server..." "up a web server..."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:11 #: ../../../_source/mail-libre-is.rst:9
msgid "Main Components" msgid ""
"The initial Administration section is for after the server has been set up "
"and configured. Below it is how the server is set up."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:13 #: ../../../_source/mail-libre-is.rst:14
msgid "This install is based on this guide:" msgid "Administration"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:15 #: ../../../_source/mail-libre-is.rst:15
msgid "`<https://workaround.org/ispmail-bookworm/>`_" msgid "Now that everything is working..."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:17 #: ../../../_source/mail-libre-is.rst:17
msgid "Log into the database using the mailadmin databse password:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:25
msgid "List Virtual Domains"
msgstr ""
#: ../../../_source/mail-libre-is.rst:33
msgid "List Virtual Users"
msgstr ""
#: ../../../_source/mail-libre-is.rst:41
msgid "List Virtual Aliases"
msgstr ""
#: ../../../_source/mail-libre-is.rst:49
msgid "Add Virtual Domain"
msgstr ""
#: ../../../_source/mail-libre-is.rst:51
msgid "Add the domain:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:59
msgid "Add a Mail User"
msgstr ""
#: ../../../_source/mail-libre-is.rst:60
msgid "Generate a password with dovecot:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:66
msgid ""
"Log into database as mailadmin and run this command, using the dovecot "
"generated password string, and set the domain and user email."
msgstr ""
#: ../../../_source/mail-libre-is.rst:69
msgid "Note, upstream docs are missing \"(\" and \")\" for VALUES."
msgstr ""
#: ../../../_source/mail-libre-is.rst:79
msgid "Add a User Alias"
msgstr ""
#: ../../../_source/mail-libre-is.rst:80
msgid ""
"Example to add an alias. The first email should be the alias, the second "
"email is where it should go to."
msgstr ""
#: ../../../_source/mail-libre-is.rst:91
msgid "Change a User Password"
msgstr ""
#: ../../../_source/mail-libre-is.rst:92
msgid "Generate string for new password:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:98
msgid "Use that string:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:106
msgid "Delete Virtual Domain"
msgstr ""
#: ../../../_source/mail-libre-is.rst:114
msgid "Delete User"
msgstr ""
#: ../../../_source/mail-libre-is.rst:122
msgid "Delete Alias"
msgstr ""
#: ../../../_source/mail-libre-is.rst:130
msgid "Email Client Setup"
msgstr ""
#: ../../../_source/mail-libre-is.rst:131
msgid "Set up mail clients thusly."
msgstr ""
#: ../../../_source/mail-libre-is.rst:135
msgid "Thunderbird"
msgstr ""
#: ../../../_source/mail-libre-is.rst:136
msgid "Example email Address: username@libre.is"
msgstr ""
#: ../../../_source/mail-libre-is.rst:158
msgid "Main Components"
msgstr ""
#: ../../../_source/mail-libre-is.rst:160
msgid "This install is based on this guide:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:162
msgid "`<https://workaround.org/ispmail-bookworm/>`_"
msgstr ""
#: ../../../_source/mail-libre-is.rst:164
msgid "" msgid ""
"For more information and details about what is what, refer to that site." "For more information and details about what is what, refer to that site."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:20 ../../../_source/mail-libre-is.rst:252 #: ../../../_source/mail-libre-is.rst:167
#: ../../../_source/mail-libre-is.rst:399
msgid "Dovecot" msgid "Dovecot"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:22 #: ../../../_source/mail-libre-is.rst:169
msgid "`<https://dovecot.org/>`_" msgid "`<https://dovecot.org/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:25 ../../../_source/mail-libre-is.rst:98 #: ../../../_source/mail-libre-is.rst:172
#: ../../../_source/mail-libre-is.rst:245
msgid "MariaDB" msgid "MariaDB"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:28 ../../../_source/mail-libre-is.rst:857 #: ../../../_source/mail-libre-is.rst:175
#: ../../../_source/mail-libre-is.rst:872
msgid "OpenDMARC" msgid "OpenDMARC"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:30 #: ../../../_source/mail-libre-is.rst:177
msgid "`<http://www.trusteddomain.org/opendmarc/>`_" msgid "`<http://www.trusteddomain.org/opendmarc/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:32 #: ../../../_source/mail-libre-is.rst:179
msgid "`<https://github.com/trusteddomainproject/OpenDMARC>`_" msgid "`<https://github.com/trusteddomainproject/OpenDMARC>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:34 ../../../_source/mail-libre-is.rst:150 #: ../../../_source/mail-libre-is.rst:181
#: ../../../_source/mail-libre-is.rst:297
msgid "Postfix" msgid "Postfix"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:36 #: ../../../_source/mail-libre-is.rst:183
msgid "`<https://www.postfix.org/>`_" msgid "`<https://www.postfix.org/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:40 #: ../../../_source/mail-libre-is.rst:187
msgid "DNS" msgid "DNS"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:41 #: ../../../_source/mail-libre-is.rst:188
msgid "Add a DNS mx record, so it returns result like this:" msgid "Add a DNS mx record, so it returns result like this:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:48 #: ../../../_source/mail-libre-is.rst:195
msgid "Set IP for mail.libre.is. Set up reverse DNS records." msgid "Set IP for mail.libre.is. Set up reverse DNS records."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:53 #: ../../../_source/mail-libre-is.rst:200
msgid "Debian" msgid "Debian"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:54 #: ../../../_source/mail-libre-is.rst:201
msgid "" msgid ""
"Install Debian stable (bookworm). Install rsyslog for old school convenience:" "Install Debian stable (bookworm). Install rsyslog for old school convenience:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:63 #: ../../../_source/mail-libre-is.rst:210
msgid "Firewall" msgid "Firewall"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:64 #: ../../../_source/mail-libre-is.rst:211
msgid "Open TCP ports." msgid "Open TCP ports."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:84 #: ../../../_source/mail-libre-is.rst:231
msgid "Apache" msgid "Apache"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:85 #: ../../../_source/mail-libre-is.rst:232
msgid "" msgid ""
"The Apache webserver is used out of laziness as it allows easy certificate " "The Apache webserver is used out of laziness as it allows easy certificate "
"updates with certbot. A webmail server won't be running on the main mail " "updates with certbot. A webmail server won't be running on the main mail "
"server." "server."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:94 #: ../../../_source/mail-libre-is.rst:241
msgid "Open up firewall ports 80 and 443." msgid "Open up firewall ports 80 and 443."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:99 #: ../../../_source/mail-libre-is.rst:246
msgid "The main database server." msgid "The main database server."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:107 #: ../../../_source/mail-libre-is.rst:254
msgid "Add databases. Change password to something secure." msgid "Add databases. Change password to something secure."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:151 #: ../../../_source/mail-libre-is.rst:298
msgid "The main SMTP mail server." msgid "The main SMTP mail server."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:158 #: ../../../_source/mail-libre-is.rst:305
msgid "" msgid ""
"Set up postfix to use MariaDB. Edit /etc/postfix/mysql-virtual-mailbox-" "Set up postfix to use MariaDB. Edit /etc/postfix/mysql-virtual-mailbox-"
"domains.cf and add below, using the mailserver password used in MariaDB." "domains.cf and add below, using the mailserver password used in MariaDB."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:171 #: ../../../_source/mail-libre-is.rst:318
msgid "Edit /etc/postfix/mysql-virtual-mailbox-maps.cf and add below contents:" msgid "Edit /etc/postfix/mysql-virtual-mailbox-maps.cf and add below contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:181 #: ../../../_source/mail-libre-is.rst:328
msgid "Edit /etc/postfix/mysql-virtual-alias-maps.cf and add below:" msgid "Edit /etc/postfix/mysql-virtual-alias-maps.cf and add below:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:191 #: ../../../_source/mail-libre-is.rst:338
msgid "Edit /etc/postfix/mysql-email2email.cf and add:" msgid "Edit /etc/postfix/mysql-email2email.cf and add:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:201 #: ../../../_source/mail-libre-is.rst:348
msgid "Then run these commands:" msgid "Then run these commands:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:218 #: ../../../_source/mail-libre-is.rst:365
msgid "Redis" msgid "Redis"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:219 #: ../../../_source/mail-libre-is.rst:366
msgid "" msgid ""
"Note, the licensing of Redis has gone bad. The version in Debian is OK. But " "Note, the licensing of Redis has gone bad. The version in Debian is OK. But "
"in the future, probably replace with a fork." "in the future, probably replace with a fork."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:228 #: ../../../_source/mail-libre-is.rst:375
msgid "rspamd" msgid "rspamd"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:229 #: ../../../_source/mail-libre-is.rst:376
msgid "Spam control." msgid "Spam control."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:237 #: ../../../_source/mail-libre-is.rst:384
msgid "Certbot" msgid "Certbot"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:238 #: ../../../_source/mail-libre-is.rst:385
msgid "" msgid ""
"Encryption certificates with Let's Encrypt. Not using an Apache webserver on " "Encryption certificates with Let's Encrypt. Not using an Apache webserver on "
"the mail server makes getting new certificates a bit more complex." "the mail server makes getting new certificates a bit more complex."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:253 #: ../../../_source/mail-libre-is.rst:400
msgid "Just using encrypted IMAPS, not POP." msgid "Just using encrypted IMAPS, not POP."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:260 #: ../../../_source/mail-libre-is.rst:407
msgid "" msgid ""
"Note, since IPv6 isn't being used, the dovecot install barfs. Edit /etc/" "Note, since IPv6 isn't being used, the dovecot install barfs. Edit /etc/"
"dovecot/dovecot.conf and add this line, where appropriate:" "dovecot/dovecot.conf and add this line, where appropriate:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:267 #: ../../../_source/mail-libre-is.rst:414
msgid "" msgid ""
"Note, this is removing the \"::\" from listen, which using IPv6. Then re-run " "Note, this is removing the \"::\" from listen, which using IPv6. Then re-run "
"the install so the packages are happy. Note, the re-install won't overwrite " "the install so the packages are happy. Note, the re-install won't overwrite "
"the \"listen\" change." "the \"listen\" change."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:276 #: ../../../_source/mail-libre-is.rst:423
msgid "Add user and set up configs" msgid "Add user and set up configs"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:304 #: ../../../_source/mail-libre-is.rst:451
msgid "Edit /etc/dovecot/conf.d/10-master.conf and add:" msgid "Edit /etc/dovecot/conf.d/10-master.conf and add:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:315 #: ../../../_source/mail-libre-is.rst:462
msgid "" msgid ""
"Edit /etc/dovecot/conf.d/10-ssl.conf, set key locations, and make it " "Edit /etc/dovecot/conf.d/10-ssl.conf, set key locations, and make it "
"required." "required."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:324 #: ../../../_source/mail-libre-is.rst:471
msgid "" msgid ""
"Edit /etc/dovecot/dovecot-sql.conf.ext file and add these lines at the " "Edit /etc/dovecot/dovecot-sql.conf.ext file and add these lines at the "
"bottom, changing the password to the mailserver database password." "bottom, changing the password to the mailserver database password."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:347 #: ../../../_source/mail-libre-is.rst:494
msgid "Set file permissions." msgid "Set file permissions."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:354 #: ../../../_source/mail-libre-is.rst:501
msgid "Edit /etc/dovecot/conf.d/10-master.conf and change to:" msgid "Edit /etc/dovecot/conf.d/10-master.conf and change to:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:367 #: ../../../_source/mail-libre-is.rst:514
msgid "Restart dovecot server." msgid "Restart dovecot server."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:373 #: ../../../_source/mail-libre-is.rst:520
msgid "Run this to tell postfix to deliver to dovecot:" msgid "Run this to tell postfix to deliver to dovecot:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:379 #: ../../../_source/mail-libre-is.rst:526
msgid "Edit /etc/dovecot/conf.d/20-lmtp.conf and change line like this:" msgid "Edit /etc/dovecot/conf.d/20-lmtp.conf and change line like this:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:386 #: ../../../_source/mail-libre-is.rst:533
msgid "Restart dovecot again...." msgid "Restart dovecot again...."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:394 #: ../../../_source/mail-libre-is.rst:541
msgid "More postfix" msgid "More postfix"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:395 #: ../../../_source/mail-libre-is.rst:542
msgid "More postfix configuration, now that the above is set up." msgid "More postfix configuration, now that the above is set up."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:397 #: ../../../_source/mail-libre-is.rst:544
msgid "Set postfix to use dovecot for authentication:" msgid "Set postfix to use dovecot for authentication:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:411 #: ../../../_source/mail-libre-is.rst:558
msgid "Edit /etc/postfix/master.cf and change thusly:" msgid "Edit /etc/postfix/master.cf and change thusly:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:428 #: ../../../_source/mail-libre-is.rst:575
#: ../../../_source/mail-libre-is.rst:555 #: ../../../_source/mail-libre-is.rst:702
msgid "Run:" msgid "Run:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:434 #: ../../../_source/mail-libre-is.rst:581
msgid "Restart postfix:" msgid "Restart postfix:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:440 #: ../../../_source/mail-libre-is.rst:587
msgid "" msgid ""
"Does it ever end? Edit /etc/postfix/master.cf and add to bottom of " "Does it ever end? Edit /etc/postfix/master.cf and add to bottom of "
"submission section." "submission section."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:452 #: ../../../_source/mail-libre-is.rst:599
msgid "" msgid ""
"Allow aliases to send by adding this file (XXX check OK) /etc/postfix/" "Allow aliases to send by adding this file (XXX check OK) /etc/postfix/"
"aliases.cf with this contents:" "aliases.cf with this contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:460 #: ../../../_source/mail-libre-is.rst:607
msgid "Make sure all is good:" msgid "Make sure all is good:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:468 #: ../../../_source/mail-libre-is.rst:615
msgid "rspamd Configuration" msgid "rspamd Configuration"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:469 #: ../../../_source/mail-libre-is.rst:616
msgid "Configure postfix for rspamd." msgid "Configure postfix for rspamd."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:477 #: ../../../_source/mail-libre-is.rst:624
msgid "Edit /etc/rspamd/override.d/milter_headers.conf and add:" msgid "Edit /etc/rspamd/override.d/milter_headers.conf and add:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:483 #: ../../../_source/mail-libre-is.rst:630
msgid "Edit /etc/dovecot/conf.d/90-sieve.conf and change:" msgid "Edit /etc/dovecot/conf.d/90-sieve.conf and change:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:489 #: ../../../_source/mail-libre-is.rst:636
msgid "Create dir for new sieve filter:" msgid "Create dir for new sieve filter:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:495 #: ../../../_source/mail-libre-is.rst:642
msgid "" msgid ""
"Create /etc/dovecot/sieve-after/spam-to-folder.sieve with these contents:" "Create /etc/dovecot/sieve-after/spam-to-folder.sieve with these contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:506 #: ../../../_source/mail-libre-is.rst:653
msgid "Then compile it:" msgid "Then compile it:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:512 #: ../../../_source/mail-libre-is.rst:659
msgid "Set up redis by adding /etc/rspamd/override.d/redis.conf with this:" msgid "Set up redis by adding /etc/rspamd/override.d/redis.conf with this:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:518 #: ../../../_source/mail-libre-is.rst:665
msgid "" msgid ""
"Add this /etc/rspamd/override.d/classifier-bayes.conf with below contents:" "Add this /etc/rspamd/override.d/classifier-bayes.conf with below contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:524 #: ../../../_source/mail-libre-is.rst:671
msgid "Add /etc/rspamd/local.d/classifier-bayes.conf with:" msgid "Add /etc/rspamd/local.d/classifier-bayes.conf with:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:530 #: ../../../_source/mail-libre-is.rst:677
msgid "Edit /etc/dovecot/conf.d/20-imap.conf and change:" msgid "Edit /etc/dovecot/conf.d/20-imap.conf and change:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:536 #: ../../../_source/mail-libre-is.rst:683
msgid "" msgid ""
"Edit /etc/dovecot/conf.d/90-sieve.conf and add below to \"plugins\" section:" "Edit /etc/dovecot/conf.d/90-sieve.conf and add below to \"plugins\" section:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:561 #: ../../../_source/mail-libre-is.rst:708
msgid "Create /etc/dovecot/sieve/learn-spam.sieve with contents:" msgid "Create /etc/dovecot/sieve/learn-spam.sieve with contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:568 #: ../../../_source/mail-libre-is.rst:715
msgid "Create /etc/dovecot/sieve/learn-ham.sieve and add:" msgid "Create /etc/dovecot/sieve/learn-ham.sieve and add:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:582 #: ../../../_source/mail-libre-is.rst:729
msgid "Run this to compile:" msgid "Run this to compile:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:591 #: ../../../_source/mail-libre-is.rst:738
msgid "Create /etc/dovecot/sieve/rspamd-learn-spam.sh with contents:" msgid "Create /etc/dovecot/sieve/rspamd-learn-spam.sh with contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:598 #: ../../../_source/mail-libre-is.rst:745
msgid "Create /etc/dovecot/sieve/rspamd-learn-ham.sh with contents:" msgid "Create /etc/dovecot/sieve/rspamd-learn-ham.sh with contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:605 #: ../../../_source/mail-libre-is.rst:752
msgid "Set ownership and permissions on scripts:" msgid "Set ownership and permissions on scripts:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:614 #: ../../../_source/mail-libre-is.rst:761
msgid "Unbound" msgid "Unbound"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:615 #: ../../../_source/mail-libre-is.rst:762
msgid "" msgid ""
"For proper spam filtering with rspam, unbound DNS resolver should be used." "For proper spam filtering with rspam, unbound DNS resolver should be used."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:621 #: ../../../_source/mail-libre-is.rst:768
msgid "Change /etc/resolv.conf to:" msgid "Change /etc/resolv.conf to:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:628 #: ../../../_source/mail-libre-is.rst:775
msgid "Also add to /etc/rspamd/local.d/options.inc" msgid "Also add to /etc/rspamd/local.d/options.inc"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:638 #: ../../../_source/mail-libre-is.rst:785
msgid "DKIM" msgid "DKIM"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:639 #: ../../../_source/mail-libre-is.rst:786
msgid "Set up DNS for DKIM." msgid "Set up DNS for DKIM."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:648 #: ../../../_source/mail-libre-is.rst:795
msgid "" msgid ""
"Add a 2024090101._domainkey TXT DNS record at the ISP, with contents of the " "Add a 2024090101._domainkey TXT DNS record at the ISP, with contents of the "
"\"p=\" and the rest, for example:" "\"p=\" and the rest, for example:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:655 #: ../../../_source/mail-libre-is.rst:802
msgid "Create /etc/rspamd/local.d/dkim_signing.conf with contents:" msgid "Create /etc/rspamd/local.d/dkim_signing.conf with contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:662 #: ../../../_source/mail-libre-is.rst:809
msgid "Create /etc/rspamd/dkim_selectors.map with contents:" msgid "Create /etc/rspamd/dkim_selectors.map with contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:668 #: ../../../_source/mail-libre-is.rst:815
msgid "Restart again..." msgid "Restart again..."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:674 #: ../../../_source/mail-libre-is.rst:821
msgid "" msgid ""
"Take teh contents from running dkim_keygen above and add it this file: /var/" "Take teh contents from running dkim_keygen above and add it this file: /var/"
"lib/rspamd/dkim/libre.is.2024090101.key" "lib/rspamd/dkim/libre.is.2024090101.key"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:677 #: ../../../_source/mail-libre-is.rst:824
msgid "" msgid ""
"Just add the PRIVATE KEY section, not the last two lines. Fix it's " "Just add the PRIVATE KEY section, not the last two lines. Fix it's "
"permissions:" "permissions:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:687 #: ../../../_source/mail-libre-is.rst:834
msgid "SPF"
msgstr ""
#: ../../../_source/mail-libre-is.rst:835
msgid "Set up SPF."
msgstr ""
#: ../../../_source/mail-libre-is.rst:837
msgid "Add a DNS TXT record like this:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:845
msgid "Spamhaus" msgid "Spamhaus"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:688 #: ../../../_source/mail-libre-is.rst:846
msgid "" msgid ""
"Spamhaus may automagically list the IP to be blocked when it is new. To " "Spamhaus may automagically list the IP to be blocked when it is new. To "
"remove, just go to:" "remove, just go to:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:691 #: ../../../_source/mail-libre-is.rst:849
msgid "`<https://www.spamhaus.org/returnc/pub/>`_" msgid "`<https://www.spamhaus.org/returnc/pub/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:693 #: ../../../_source/mail-libre-is.rst:851
msgid "" msgid ""
"Then enter the IP address of the server and fill out the form. They will " "Then enter the IP address of the server and fill out the form. They will "
"send a confirmation email with a link. Go to that link and it will be " "send a confirmation email with a link. Go to that link and it will be "
"immediately removed." "immediately removed."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:699 #: ../../../_source/mail-libre-is.rst:857
msgid "Administration"
msgstr ""
#: ../../../_source/mail-libre-is.rst:700
msgid "Now that everything is working..."
msgstr ""
#: ../../../_source/mail-libre-is.rst:702
msgid "Log into the database using the mailadmin databse password:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:710
msgid "List Virtual Domains"
msgstr ""
#: ../../../_source/mail-libre-is.rst:718
msgid "List Virtual Users"
msgstr ""
#: ../../../_source/mail-libre-is.rst:726
msgid "List Virtual Aliases"
msgstr ""
#: ../../../_source/mail-libre-is.rst:734
msgid "Add Virtual Domain"
msgstr ""
#: ../../../_source/mail-libre-is.rst:736
msgid "Add the domain:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:744
msgid "Add a Mail User"
msgstr ""
#: ../../../_source/mail-libre-is.rst:745
msgid "Generate a password with dovecot:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:751
msgid ""
"Log into database as mailadmin and run this command, using the dovecot "
"generated password string, and set the domain and user email."
msgstr ""
#: ../../../_source/mail-libre-is.rst:754
msgid "Note, upstream docs are missing \"(\" and \")\" for VALUES."
msgstr ""
#: ../../../_source/mail-libre-is.rst:764
msgid "Add a User Alias"
msgstr ""
#: ../../../_source/mail-libre-is.rst:765
msgid ""
"Example to add an alias. The first email should be the alias, the second "
"email is where it should go to."
msgstr ""
#: ../../../_source/mail-libre-is.rst:776
msgid "Change a User Password"
msgstr ""
#: ../../../_source/mail-libre-is.rst:777
msgid "Generate string for new password:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:783
msgid "Use that string:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:791
msgid "Delete Virtual Domain"
msgstr ""
#: ../../../_source/mail-libre-is.rst:799
msgid "Delete User"
msgstr ""
#: ../../../_source/mail-libre-is.rst:807
msgid "Delete Alias"
msgstr ""
#: ../../../_source/mail-libre-is.rst:815
msgid "Email Client Setup"
msgstr ""
#: ../../../_source/mail-libre-is.rst:816
msgid "Set up mail clients thusly."
msgstr ""
#: ../../../_source/mail-libre-is.rst:820
msgid "Thunderbird"
msgstr ""
#: ../../../_source/mail-libre-is.rst:821
msgid "Example email Address: username@libre.is"
msgstr ""
#: ../../../_source/mail-libre-is.rst:842
msgid "Other" msgid "Other"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:843 #: ../../../_source/mail-libre-is.rst:858
msgid "Perhaps these too." msgid "Perhaps these too."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:850 #: ../../../_source/mail-libre-is.rst:865
msgid "Perhaps easier to admin with this script." msgid "Perhaps easier to admin with this script."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:852 #: ../../../_source/mail-libre-is.rst:867
msgid "`<https://github.com/cgzones/ispmail-userctl>`_" msgid "`<https://github.com/cgzones/ispmail-userctl>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:858 #: ../../../_source/mail-libre-is.rst:873
msgid "Requires database setup." msgid "Requires database setup."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:867
msgid "SPF"
msgstr ""
#: ../../../_source/mail-libre-is.rst:868
msgid "Set up SPF."
msgstr ""

View file

@ -6,6 +6,153 @@ Documentation for Libre mail server.
Setting up Internet mail servers is a pain. Setting up Internet mail servers is a pain.
It's nothing like just setting up a web server... It's nothing like just setting up a web server...
The initial Administration section is for after the server has
been set up and configured. Below it is how the server is set up.
Administration
==============
Now that everything is working...
Log into the database using the mailadmin databse password:
.. code-block:: sh
mariadb -u mailadmin -p mailserver
List Virtual Domains
--------------------
.. code-block:: sql
SELECT * FROM virtual_domains;
List Virtual Users
------------------
.. code-block:: sql
SELECT * FROM virtual_users;
List Virtual Aliases
--------------------
.. code-block:: sql
SELECT * FROM virtual_aliases;
Add Virtual Domain
------------------
Add the domain:
.. code-block:: sql
INSERT INTO virtual_domains (name) VALUES ("example.org");
Add a Mail User
---------------
Generate a password with dovecot:
.. code-block:: sh
sudo dovecot pw -s BLF-CRYPT
Log into database as mailadmin and run this command, using the dovecot
generated password string, and set the domain and user email.
Note, upstream docs are missing "(" and ")" for VALUES.
.. code-block:: sql
INSERT INTO virtual_users (domain_id, email, password) VALUES
((SELECT id FROM virtual_domains WHERE name='example.org'),
'john@example.org','{BLF-CRYPT}$2y$05$.We…');
Add a User Alias
----------------
Example to add an alias. The first email should be the alias,
the second email is where it should go to.
.. code-block:: sql
INSERT INTO virtual_aliases (domain_id, source, destination) VALUES
( (SELECT id FROM virtual_domains WHERE name='example.org'),
'melissa@example.org', 'juila@example.net');
Change a User Password
----------------------
Generate string for new password:
.. code-block:: sh
sudo dovecot pw -s BLF-CRYPT
Use that string:
.. code-block:: sql
UPDATE virtual_users SET password='{BLF-CRYPT}$2y$05$.We…' WHERE email='email@address';
Delete Virtual Domain
---------------------
.. code-block:: sql
DELETE FROM virtual_domains where name='example.org';
Delete User
-----------
.. code-block:: sql
DELETE FROM virtual_users WHERE email='john@example.org';
Delete Alias
------------
.. code-block:: sql
DELETE FROM virtual_aliases WHERE source='melissa@example.org';
Email Client Setup
==================
Set up mail clients thusly.
Thunderbird
-----------
Example email Address: username@libre.is
.. code-block:: cfg
Incoming Server
Hostname: mail.libre.is
Protocol: IMAP
Port: 993
Connection Security: SSL/TLS
Authenication Method: Normal Password
Username: username@libre.is (same as email address)
Outgoing Server
Hostname: mail.libre.is
Port: 587
Connection Security: STARTTLS
Authenication Method: Normal Password
Username: username@libre.is (same as email address)
Main Components Main Components
=============== ===============
@ -683,6 +830,17 @@ Fix it's permissions:
sudo chmod 400 /var/lib/rspamd/dkim/libre.is.2024090101.key sudo chmod 400 /var/lib/rspamd/dkim/libre.is.2024090101.key
SPF
===
Set up SPF.
Add a DNS TXT record like this:
.. code-block:: cfg
v=spf1 mx a ip4:70.39.110.156/32 include:mail.libre.is -all
Spamhaus Spamhaus
======== ========
Spamhaus may automagically list the IP to be blocked when it is new. Spamhaus may automagically list the IP to be blocked when it is new.
@ -695,149 +853,6 @@ They will send a confirmation email with a link.
Go to that link and it will be immediately removed. Go to that link and it will be immediately removed.
Administration
==============
Now that everything is working...
Log into the database using the mailadmin databse password:
.. code-block:: sh
mariadb -u mailadmin -p mailserver
List Virtual Domains
--------------------
.. code-block:: sql
SELECT * FROM virtual_domains;
List Virtual Users
------------------
.. code-block:: sql
SELECT * FROM virtual_users;
List Virtual Aliases
--------------------
.. code-block:: sql
SELECT * FROM virtual_aliases;
Add Virtual Domain
------------------
Add the domain:
.. code-block:: sql
INSERT INTO virtual_domains (name) VALUES ("example.org");
Add a Mail User
---------------
Generate a password with dovecot:
.. code-block:: sh
sudo dovecot pw -s BLF-CRYPT
Log into database as mailadmin and run this command, using the dovecot
generated password string, and set the domain and user email.
Note, upstream docs are missing "(" and ")" for VALUES.
.. code-block:: sql
INSERT INTO virtual_users (domain_id, email, password) VALUES
((SELECT id FROM virtual_domains WHERE name='example.org'),
'john@example.org','{BLF-CRYPT}$2y$05$.We…');
Add a User Alias
----------------
Example to add an alias. The first email should be the alias,
the second email is where it should go to.
.. code-block:: sql
INSERT INTO virtual_aliases (domain_id, source, destination) VALUES
( (SELECT id FROM virtual_domains WHERE name='example.org'),
'melissa@example.org', 'juila@example.net');
Change a User Password
----------------------
Generate string for new password:
.. code-block:: sh
sudo dovecot pw -s BLF-CRYPT
Use that string:
.. code-block:: sql
UPDATE virtual_users SET password='{BLF-CRYPT}$2y$05$.We…' WHERE email='email@address';
Delete Virtual Domain
---------------------
.. code-block:: sql
DELETE FROM virtual_domains where name='example.org';
Delete User
-----------
.. code-block:: sql
DELETE FROM virtual_users WHERE email='john@example.org';
Delete Alias
------------
.. code-block:: sql
DELETE FROM virtual_aliases WHERE source='melissa@example.org';
Email Client Setup
==================
Set up mail clients thusly.
Thunderbird
-----------
Example email Address: username@libre.is
.. code-block:: cfg
Incoming Server
Hostname: mail.libre.is
Protocol: IMAP
Port: 993
Connection Security: SSL/TLS
Authenication Method: Normal Password
Username: username@libre.is (same as email address)
Outgoing Server
Hostname: mail.libre.is
Port: 587
Connection Security: STARTTLS
Authenication Method: Normal Password
Username: username@libre.is (same as email address)
Other Other
===== =====
Perhaps these too. Perhaps these too.
@ -863,8 +878,4 @@ Requires database setup.
sudo apt install opendmarc sudo apt install opendmarc
SPF
===
Set up SPF.