libre/dev-libre-is
libre/dev-libre-is
4
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

Add ispmail_userctl.

Browse source
This commit is contained in:
Jeff Moe 2024-09-01 17:40:46 -06:00
parent 1b62301458
commit 8af8209ddf
2 changed files with 238 additions and 148 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

326
docs/_source/locale/en/LC_MESSAGES/mail-libre-is.po
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 16:05-0600\n" "POT-Creation-Date: 2024-09-01 17:39-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"
@ -45,556 +45,602 @@ msgid "Administration"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:15 #: ../../../_source/mail-libre-is.rst:15
msgid "Now that everything is working..." msgid "Once everything is setup working..."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:17 #: ../../../_source/mail-libre-is.rst:19
msgid "Log into the database using the mailadmin databse password:" msgid "ispmail_userctl"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:25 #: ../../../_source/mail-libre-is.rst:20
msgid "The easiest way to admin is to run this script:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:28
msgid "Database"
msgstr ""
#: ../../../_source/mail-libre-is.rst:29
msgid ""
"To admin directly, log into the database using the mailadmin database "
"password:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:38
msgid "List Virtual Domains" msgid "List Virtual Domains"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:33 #: ../../../_source/mail-libre-is.rst:46
msgid "List Virtual Users" msgid "List Virtual Users"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:41 #: ../../../_source/mail-libre-is.rst:54
msgid "List Virtual Aliases" msgid "List Virtual Aliases"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:49 #: ../../../_source/mail-libre-is.rst:62
msgid "Add Virtual Domain" msgid "Add Virtual Domain"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:51 #: ../../../_source/mail-libre-is.rst:64
msgid "Add the domain:" msgid "Add the domain:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:59 #: ../../../_source/mail-libre-is.rst:72
msgid "Add a Mail User" msgid "Add a Mail User"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:60 #: ../../../_source/mail-libre-is.rst:73
msgid "Generate a password with dovecot:" msgid "Generate a password with dovecot:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:66 #: ../../../_source/mail-libre-is.rst:79
msgid "" msgid ""
"Log into database as mailadmin and run this command, using the dovecot " "Log into database as mailadmin and run this command, using the dovecot "
"generated password string, and set the domain and user email." "generated password string, and set the domain and user email."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:69 #: ../../../_source/mail-libre-is.rst:82
msgid "Note, upstream docs are missing \"(\" and \")\" for VALUES." msgid "Note, upstream docs are missing \"(\" and \")\" for VALUES."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:79 #: ../../../_source/mail-libre-is.rst:92
msgid "Add a User Alias" msgid "Add a User Alias"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:80 #: ../../../_source/mail-libre-is.rst:93
msgid "" msgid ""
"Example to add an alias. The first email should be the alias, the second " "Example to add an alias. The first email should be the alias, the second "
"email is where it should go to." "email is where it should go to."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:91 #: ../../../_source/mail-libre-is.rst:104
msgid "Change a User Password" msgid "Change a User Password"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:92 #: ../../../_source/mail-libre-is.rst:105
msgid "Generate string for new password:" msgid "Generate string for new password:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:98 #: ../../../_source/mail-libre-is.rst:111
msgid "Use that string:" msgid "Use that string:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:106 #: ../../../_source/mail-libre-is.rst:119
msgid "Delete Virtual Domain" msgid "Delete Virtual Domain"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:114 #: ../../../_source/mail-libre-is.rst:127
msgid "Delete User" msgid "Delete User"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:122 #: ../../../_source/mail-libre-is.rst:135
msgid "Delete Alias" msgid "Delete Alias"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:130 #: ../../../_source/mail-libre-is.rst:143
msgid "Email Client Setup" msgid "Email Client Setup"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:131 #: ../../../_source/mail-libre-is.rst:144
msgid "Set up mail clients thusly." msgid "Set up mail clients, such as Thunderbird, thusly."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:135 #: ../../../_source/mail-libre-is.rst:146
msgid "Thunderbird" msgid "Using example email address username@libre.is."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:136 #: ../../../_source/mail-libre-is.rst:167
msgid "Example email Address: username@libre.is"
msgstr ""
#: ../../../_source/mail-libre-is.rst:158
msgid "Main Components" msgid "Main Components"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:160 #: ../../../_source/mail-libre-is.rst:169
msgid "This install is based on this guide:" msgid "This install is based on this guide:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:162 #: ../../../_source/mail-libre-is.rst:171
msgid "`<https://workaround.org/ispmail-bookworm/>`_" msgid "`<https://workaround.org/ispmail-bookworm/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:164 #: ../../../_source/mail-libre-is.rst:173
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:167 #: ../../../_source/mail-libre-is.rst:176
msgid "The main components in use:" msgid "The main components in use:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:169 #: ../../../_source/mail-libre-is.rst:178
msgid "Certbot (Let's Encrypt)" msgid "Certbot (Let's Encrypt)"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:171 #: ../../../_source/mail-libre-is.rst:180
msgid "`<https://certbot.eff.org/>`_" msgid "`<https://certbot.eff.org/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:173 #: ../../../_source/mail-libre-is.rst:182
#: ../../../_source/mail-libre-is.rst:217 #: ../../../_source/mail-libre-is.rst:226
msgid "Debian" msgid "Debian"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:175 #: ../../../_source/mail-libre-is.rst:184
msgid "`<https://debian.org/>`_" msgid "`<https://debian.org/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:177 #: ../../../_source/mail-libre-is.rst:186
#: ../../../_source/mail-libre-is.rst:416 #: ../../../_source/mail-libre-is.rst:425
msgid "Dovecot" msgid "Dovecot"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:179 #: ../../../_source/mail-libre-is.rst:188
msgid "`<https://dovecot.org/>`_" msgid "`<https://dovecot.org/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:182 #: ../../../_source/mail-libre-is.rst:191
#: ../../../_source/mail-libre-is.rst:262 #: ../../../_source/mail-libre-is.rst:271
msgid "MariaDB" msgid "MariaDB"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:184 #: ../../../_source/mail-libre-is.rst:193
msgid "`<https://mariadb.org/>`_" msgid "`<https://mariadb.org/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:186 #: ../../../_source/mail-libre-is.rst:195
#: ../../../_source/mail-libre-is.rst:314 #: ../../../_source/mail-libre-is.rst:323
msgid "Postfix" msgid "Postfix"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:188 #: ../../../_source/mail-libre-is.rst:197
msgid "`<https://www.postfix.org/>`_" msgid "`<https://www.postfix.org/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:190 #: ../../../_source/mail-libre-is.rst:199
msgid "redis" msgid "redis"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:192 #: ../../../_source/mail-libre-is.rst:201
msgid "`<https://redis.io/>`_" msgid "`<https://redis.io/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:194 #: ../../../_source/mail-libre-is.rst:203
#: ../../../_source/mail-libre-is.rst:392 #: ../../../_source/mail-libre-is.rst:401
msgid "rspamd" msgid "rspamd"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:196 #: ../../../_source/mail-libre-is.rst:205
msgid "`<https://rspamd.com/>`_" msgid "`<https://rspamd.com/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:198 #: ../../../_source/mail-libre-is.rst:207
msgid "unbound" msgid "unbound"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:200 #: ../../../_source/mail-libre-is.rst:209
msgid "`<https://www.unbound.net/>`_" msgid "`<https://www.unbound.net/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:204 #: ../../../_source/mail-libre-is.rst:213
msgid "DNS" msgid "DNS"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:205 #: ../../../_source/mail-libre-is.rst:214
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:212 #: ../../../_source/mail-libre-is.rst:221
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:218 #: ../../../_source/mail-libre-is.rst:227
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:227 #: ../../../_source/mail-libre-is.rst:236
msgid "Firewall" msgid "Firewall"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:228 #: ../../../_source/mail-libre-is.rst:237
msgid "Open TCP ports." msgid "Open TCP ports."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:248 #: ../../../_source/mail-libre-is.rst:257
msgid "Apache" msgid "Apache"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:249 #: ../../../_source/mail-libre-is.rst:258
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:258 #: ../../../_source/mail-libre-is.rst:267
msgid "Open up firewall ports 80 and 443." msgid "Open up firewall ports 80 and 443."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:263 #: ../../../_source/mail-libre-is.rst:272
msgid "The main database server." msgid "The main database server."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:271 #: ../../../_source/mail-libre-is.rst:280
msgid "Add databases. Change password to something secure." msgid "Add databases. Change password to something secure."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:315 #: ../../../_source/mail-libre-is.rst:324
msgid "The main SMTP mail server." msgid "The main SMTP mail server."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:322 #: ../../../_source/mail-libre-is.rst:331
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:335 #: ../../../_source/mail-libre-is.rst:344
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:345 #: ../../../_source/mail-libre-is.rst:354
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:355 #: ../../../_source/mail-libre-is.rst:364
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:365 #: ../../../_source/mail-libre-is.rst:374
msgid "Then run these commands:" msgid "Then run these commands:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:382 #: ../../../_source/mail-libre-is.rst:391
msgid "Redis" msgid "Redis"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:383 #: ../../../_source/mail-libre-is.rst:392
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:393 #: ../../../_source/mail-libre-is.rst:402
msgid "Spam control." msgid "Spam control."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:401 #: ../../../_source/mail-libre-is.rst:410
msgid "Certbot" msgid "Certbot"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:402 #: ../../../_source/mail-libre-is.rst:411
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:417 #: ../../../_source/mail-libre-is.rst:426
msgid "Just using encrypted IMAPS, not POP." msgid "Just using encrypted IMAPS, not POP."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:424 #: ../../../_source/mail-libre-is.rst:433
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:431 #: ../../../_source/mail-libre-is.rst:440
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:440 #: ../../../_source/mail-libre-is.rst:449
msgid "Add user and set up configs" msgid "Add user and set up configs"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:468 #: ../../../_source/mail-libre-is.rst:477
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:479 #: ../../../_source/mail-libre-is.rst:488
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:488 #: ../../../_source/mail-libre-is.rst:497
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:511 #: ../../../_source/mail-libre-is.rst:520
msgid "Set file permissions." msgid "Set file permissions."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:518 #: ../../../_source/mail-libre-is.rst:527
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:531 #: ../../../_source/mail-libre-is.rst:540
msgid "Restart dovecot server." msgid "Restart dovecot server."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:537 #: ../../../_source/mail-libre-is.rst:546
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:543 #: ../../../_source/mail-libre-is.rst:552
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:550 #: ../../../_source/mail-libre-is.rst:559
msgid "Restart dovecot again...." msgid "Restart dovecot again...."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:558 #: ../../../_source/mail-libre-is.rst:567
msgid "More postfix" msgid "More postfix"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:559 #: ../../../_source/mail-libre-is.rst:568
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:561 #: ../../../_source/mail-libre-is.rst:570
msgid "Set postfix to use dovecot for authentication:" msgid "Set postfix to use dovecot for authentication:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:575 #: ../../../_source/mail-libre-is.rst:584
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:592 #: ../../../_source/mail-libre-is.rst:601
#: ../../../_source/mail-libre-is.rst:719 #: ../../../_source/mail-libre-is.rst:728
msgid "Run:" msgid "Run:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:598 #: ../../../_source/mail-libre-is.rst:607
msgid "Restart postfix:" msgid "Restart postfix:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:604 #: ../../../_source/mail-libre-is.rst:613
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:616 #: ../../../_source/mail-libre-is.rst:625
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:624 #: ../../../_source/mail-libre-is.rst:633
msgid "Make sure all is good:" msgid "Make sure all is good:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:632 #: ../../../_source/mail-libre-is.rst:641
msgid "rspamd Configuration" msgid "rspamd Configuration"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:633 #: ../../../_source/mail-libre-is.rst:642
msgid "Configure postfix for rspamd." msgid "Configure postfix for rspamd."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:641 #: ../../../_source/mail-libre-is.rst:650
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:647 #: ../../../_source/mail-libre-is.rst:656
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:653 #: ../../../_source/mail-libre-is.rst:662
msgid "Create dir for new sieve filter:" msgid "Create dir for new sieve filter:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:659 #: ../../../_source/mail-libre-is.rst:668
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:670 #: ../../../_source/mail-libre-is.rst:679
msgid "Then compile it:" msgid "Then compile it:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:676 #: ../../../_source/mail-libre-is.rst:685
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:682 #: ../../../_source/mail-libre-is.rst:691
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:688 #: ../../../_source/mail-libre-is.rst:697
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:694 #: ../../../_source/mail-libre-is.rst:703
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:700 #: ../../../_source/mail-libre-is.rst:709
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:725 #: ../../../_source/mail-libre-is.rst:734
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:732 #: ../../../_source/mail-libre-is.rst:741
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:746 #: ../../../_source/mail-libre-is.rst:755
msgid "Run this to compile:" msgid "Run this to compile:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:755 #: ../../../_source/mail-libre-is.rst:764
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:762 #: ../../../_source/mail-libre-is.rst:771
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:769 #: ../../../_source/mail-libre-is.rst:778
msgid "Set ownership and permissions on scripts:" msgid "Set ownership and permissions on scripts:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:778 #: ../../../_source/mail-libre-is.rst:787
msgid "Unbound" msgid "Unbound"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:779 #: ../../../_source/mail-libre-is.rst:788
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:785 #: ../../../_source/mail-libre-is.rst:794
msgid "Change /etc/resolv.conf to:" msgid "Change /etc/resolv.conf to:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:792 #: ../../../_source/mail-libre-is.rst:801
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:802 #: ../../../_source/mail-libre-is.rst:811
msgid "DKIM" msgid "DKIM"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:803 #: ../../../_source/mail-libre-is.rst:812
msgid "Set up DNS for DKIM." msgid "Set up DNS for DKIM."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:812 #: ../../../_source/mail-libre-is.rst:821
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:819 #: ../../../_source/mail-libre-is.rst:828
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:826 #: ../../../_source/mail-libre-is.rst:835
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:832 #: ../../../_source/mail-libre-is.rst:841
msgid "Restart again..." msgid "Restart again..."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:838 #: ../../../_source/mail-libre-is.rst:847
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:841 #: ../../../_source/mail-libre-is.rst:850
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:851 #: ../../../_source/mail-libre-is.rst:860
msgid "SPF" msgid "SPF"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:852 #: ../../../_source/mail-libre-is.rst:861
msgid "Set up SPF." msgid "Set up SPF."
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:854 #: ../../../_source/mail-libre-is.rst:863
msgid "Add a DNS TXT record like this:" msgid "Add a DNS TXT record like this:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:862 #: ../../../_source/mail-libre-is.rst:871
msgid "DMARC" msgid "DMARC"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:863 #: ../../../_source/mail-libre-is.rst:872
msgid "Create a DNS TXT record for the domain _dmarc.libre.is with contents:" msgid "Create a DNS TXT record for the domain _dmarc.libre.is with contents:"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:871 #: ../../../_source/mail-libre-is.rst:880
msgid "Python Admin"
msgstr ""
#: ../../../_source/mail-libre-is.rst:881
msgid "Admin with Python script."
msgstr ""
#: ../../../_source/mail-libre-is.rst:889
msgid "Edit ispmail_userctl.py and change:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:891
msgid "USE_BCRYPT: bool = True"
msgstr ""
#: ../../../_source/mail-libre-is.rst:893
msgid "Under DB_CONNECTION, change user and password to match database setup:"
msgstr ""
#: ../../../_source/mail-libre-is.rst:895
msgid "user='mailadmin'"
msgstr ""
#: ../../../_source/mail-libre-is.rst:896
msgid "password=''"
msgstr ""
#: ../../../_source/mail-libre-is.rst:898
msgid "Then move the script in place."
msgstr ""
#: ../../../_source/mail-libre-is.rst:906
msgid "Then just run it normally as root."
msgstr ""
#: ../../../_source/mail-libre-is.rst:914
msgid "Spamhaus" msgid "Spamhaus"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:872 #: ../../../_source/mail-libre-is.rst:915
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:875 #: ../../../_source/mail-libre-is.rst:918
msgid "`<https://www.spamhaus.org/returnc/pub/>`_" msgid "`<https://www.spamhaus.org/returnc/pub/>`_"
msgstr "" msgstr ""
#: ../../../_source/mail-libre-is.rst:877 #: ../../../_source/mail-libre-is.rst:920
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 "

60
docs/_source/mail-libre-is.rst
View file

@ -12,9 +12,22 @@ been set up and configured. Below it is how the server is set up.
Administration Administration
============== ==============
Now that everything is working... Once everything is setup working...
Log into the database using the mailadmin databse password:
ispmail_userctl
---------------
The easiest way to admin is to run this script:
.. code-block:: sh
sudo ispmail_userctl
Database
--------
To admin directly, log into the database using the mailadmin database
password:
.. code-block:: sh .. code-block:: sh
@ -128,12 +141,9 @@ Delete Alias
Email Client Setup Email Client Setup
================== ==================
Set up mail clients thusly. Set up mail clients, such as Thunderbird, thusly.
Using example email address username@libre.is.
Thunderbird
-----------
Example email Address: username@libre.is
.. code-block:: cfg .. code-block:: cfg
@ -153,7 +163,6 @@ Example email Address: username@libre.is
Username: username@libre.is (same as email address) Username: username@libre.is (same as email address)
Main Components Main Components
=============== ===============
@ -867,6 +876,40 @@ Create a DNS TXT record for the domain _dmarc.libre.is with contents:
v=DMARC1; p=reject; rua=mailto:postmaster@libre.is; ruf=mailto:postmaster@libre.is; fo=0; adkim=r; aspf=r; pct=100; rf=afrf; ri=86400; sp=reject v=DMARC1; p=reject; rua=mailto:postmaster@libre.is; ruf=mailto:postmaster@libre.is; fo=0; adkim=r; aspf=r; pct=100; rf=afrf; ri=86400; sp=reject
Python Admin
============
Admin with Python script.
.. code-block:: sh
sudo apt install python3-mysqldb python3-bcrypt
git clone https://github.com/cgzones/ispmail-userctl
cd ispmail-userctl/
Edit ispmail_userctl.py and change:
* USE_BCRYPT: bool = True
Under DB_CONNECTION, change user and password to match database setup:
* user='mailadmin'
* password=''
Then move the script in place.
.. code-block:: sh
sudo cp -p ispmail_userctl.py /usr/local/sbin/ispmail_userctl
sudo chown root:root /usr/local/sbin/ispmail_userctl
sudo chmod 700 /usr/local/sbin/ispmail_userctl
Then just run it normally as root.
.. code-block:: sh
sudo ispmail_userctl
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.
@ -878,3 +921,4 @@ Then enter the IP address of the server and fill out the form.
They will send a confirmation email with a link. 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.