diff --git a/docs/_source/locale/en/LC_MESSAGES/mail-libre-is.po b/docs/_source/locale/en/LC_MESSAGES/mail-libre-is.po index 5dac7e0..2368dde 100644 --- a/docs/_source/locale/en/LC_MESSAGES/mail-libre-is.po +++ b/docs/_source/locale/en/LC_MESSAGES/mail-libre-is.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Libre Developers Documentation 0\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" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -45,556 +45,602 @@ msgid "Administration" msgstr "" #: ../../../_source/mail-libre-is.rst:15 -msgid "Now that everything is working..." +msgid "Once everything is setup working..." msgstr "" -#: ../../../_source/mail-libre-is.rst:17 -msgid "Log into the database using the mailadmin databse password:" +#: ../../../_source/mail-libre-is.rst:19 +msgid "ispmail_userctl" 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" msgstr "" -#: ../../../_source/mail-libre-is.rst:33 +#: ../../../_source/mail-libre-is.rst:46 msgid "List Virtual Users" msgstr "" -#: ../../../_source/mail-libre-is.rst:41 +#: ../../../_source/mail-libre-is.rst:54 msgid "List Virtual Aliases" msgstr "" -#: ../../../_source/mail-libre-is.rst:49 +#: ../../../_source/mail-libre-is.rst:62 msgid "Add Virtual Domain" msgstr "" -#: ../../../_source/mail-libre-is.rst:51 +#: ../../../_source/mail-libre-is.rst:64 msgid "Add the domain:" msgstr "" -#: ../../../_source/mail-libre-is.rst:59 +#: ../../../_source/mail-libre-is.rst:72 msgid "Add a Mail User" msgstr "" -#: ../../../_source/mail-libre-is.rst:60 +#: ../../../_source/mail-libre-is.rst:73 msgid "Generate a password with dovecot:" msgstr "" -#: ../../../_source/mail-libre-is.rst:66 +#: ../../../_source/mail-libre-is.rst:79 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 +#: ../../../_source/mail-libre-is.rst:82 msgid "Note, upstream docs are missing \"(\" and \")\" for VALUES." msgstr "" -#: ../../../_source/mail-libre-is.rst:79 +#: ../../../_source/mail-libre-is.rst:92 msgid "Add a User Alias" msgstr "" -#: ../../../_source/mail-libre-is.rst:80 +#: ../../../_source/mail-libre-is.rst:93 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 +#: ../../../_source/mail-libre-is.rst:104 msgid "Change a User Password" msgstr "" -#: ../../../_source/mail-libre-is.rst:92 +#: ../../../_source/mail-libre-is.rst:105 msgid "Generate string for new password:" msgstr "" -#: ../../../_source/mail-libre-is.rst:98 +#: ../../../_source/mail-libre-is.rst:111 msgid "Use that string:" msgstr "" -#: ../../../_source/mail-libre-is.rst:106 +#: ../../../_source/mail-libre-is.rst:119 msgid "Delete Virtual Domain" msgstr "" -#: ../../../_source/mail-libre-is.rst:114 +#: ../../../_source/mail-libre-is.rst:127 msgid "Delete User" msgstr "" -#: ../../../_source/mail-libre-is.rst:122 +#: ../../../_source/mail-libre-is.rst:135 msgid "Delete Alias" msgstr "" -#: ../../../_source/mail-libre-is.rst:130 +#: ../../../_source/mail-libre-is.rst:143 msgid "Email Client Setup" msgstr "" -#: ../../../_source/mail-libre-is.rst:131 -msgid "Set up mail clients thusly." +#: ../../../_source/mail-libre-is.rst:144 +msgid "Set up mail clients, such as Thunderbird, thusly." msgstr "" -#: ../../../_source/mail-libre-is.rst:135 -msgid "Thunderbird" +#: ../../../_source/mail-libre-is.rst:146 +msgid "Using example email address username@libre.is." msgstr "" -#: ../../../_source/mail-libre-is.rst:136 -msgid "Example email Address: username@libre.is" -msgstr "" - -#: ../../../_source/mail-libre-is.rst:158 +#: ../../../_source/mail-libre-is.rst:167 msgid "Main Components" msgstr "" -#: ../../../_source/mail-libre-is.rst:160 +#: ../../../_source/mail-libre-is.rst:169 msgid "This install is based on this guide:" msgstr "" -#: ../../../_source/mail-libre-is.rst:162 +#: ../../../_source/mail-libre-is.rst:171 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:164 +#: ../../../_source/mail-libre-is.rst:173 msgid "" "For more information and details about what is what, refer to that site." msgstr "" -#: ../../../_source/mail-libre-is.rst:167 +#: ../../../_source/mail-libre-is.rst:176 msgid "The main components in use:" msgstr "" -#: ../../../_source/mail-libre-is.rst:169 +#: ../../../_source/mail-libre-is.rst:178 msgid "Certbot (Let's Encrypt)" msgstr "" -#: ../../../_source/mail-libre-is.rst:171 +#: ../../../_source/mail-libre-is.rst:180 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:173 -#: ../../../_source/mail-libre-is.rst:217 +#: ../../../_source/mail-libre-is.rst:182 +#: ../../../_source/mail-libre-is.rst:226 msgid "Debian" msgstr "" -#: ../../../_source/mail-libre-is.rst:175 +#: ../../../_source/mail-libre-is.rst:184 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:177 -#: ../../../_source/mail-libre-is.rst:416 +#: ../../../_source/mail-libre-is.rst:186 +#: ../../../_source/mail-libre-is.rst:425 msgid "Dovecot" msgstr "" -#: ../../../_source/mail-libre-is.rst:179 +#: ../../../_source/mail-libre-is.rst:188 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:182 -#: ../../../_source/mail-libre-is.rst:262 +#: ../../../_source/mail-libre-is.rst:191 +#: ../../../_source/mail-libre-is.rst:271 msgid "MariaDB" msgstr "" -#: ../../../_source/mail-libre-is.rst:184 +#: ../../../_source/mail-libre-is.rst:193 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:186 -#: ../../../_source/mail-libre-is.rst:314 +#: ../../../_source/mail-libre-is.rst:195 +#: ../../../_source/mail-libre-is.rst:323 msgid "Postfix" msgstr "" -#: ../../../_source/mail-libre-is.rst:188 +#: ../../../_source/mail-libre-is.rst:197 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:190 +#: ../../../_source/mail-libre-is.rst:199 msgid "redis" msgstr "" -#: ../../../_source/mail-libre-is.rst:192 +#: ../../../_source/mail-libre-is.rst:201 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:194 -#: ../../../_source/mail-libre-is.rst:392 +#: ../../../_source/mail-libre-is.rst:203 +#: ../../../_source/mail-libre-is.rst:401 msgid "rspamd" msgstr "" -#: ../../../_source/mail-libre-is.rst:196 +#: ../../../_source/mail-libre-is.rst:205 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:198 +#: ../../../_source/mail-libre-is.rst:207 msgid "unbound" msgstr "" -#: ../../../_source/mail-libre-is.rst:200 +#: ../../../_source/mail-libre-is.rst:209 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:204 +#: ../../../_source/mail-libre-is.rst:213 msgid "DNS" 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:" 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." msgstr "" -#: ../../../_source/mail-libre-is.rst:218 +#: ../../../_source/mail-libre-is.rst:227 msgid "" "Install Debian stable (bookworm). Install rsyslog for old school convenience:" msgstr "" -#: ../../../_source/mail-libre-is.rst:227 +#: ../../../_source/mail-libre-is.rst:236 msgid "Firewall" msgstr "" -#: ../../../_source/mail-libre-is.rst:228 +#: ../../../_source/mail-libre-is.rst:237 msgid "Open TCP ports." msgstr "" -#: ../../../_source/mail-libre-is.rst:248 +#: ../../../_source/mail-libre-is.rst:257 msgid "Apache" msgstr "" -#: ../../../_source/mail-libre-is.rst:249 +#: ../../../_source/mail-libre-is.rst:258 msgid "" "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 " "server." msgstr "" -#: ../../../_source/mail-libre-is.rst:258 +#: ../../../_source/mail-libre-is.rst:267 msgid "Open up firewall ports 80 and 443." msgstr "" -#: ../../../_source/mail-libre-is.rst:263 +#: ../../../_source/mail-libre-is.rst:272 msgid "The main database server." msgstr "" -#: ../../../_source/mail-libre-is.rst:271 +#: ../../../_source/mail-libre-is.rst:280 msgid "Add databases. Change password to something secure." msgstr "" -#: ../../../_source/mail-libre-is.rst:315 +#: ../../../_source/mail-libre-is.rst:324 msgid "The main SMTP mail server." msgstr "" -#: ../../../_source/mail-libre-is.rst:322 +#: ../../../_source/mail-libre-is.rst:331 msgid "" "Set up postfix to use MariaDB. Edit /etc/postfix/mysql-virtual-mailbox-" "domains.cf and add below, using the mailserver password used in MariaDB." 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:" 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:" msgstr "" -#: ../../../_source/mail-libre-is.rst:355 +#: ../../../_source/mail-libre-is.rst:364 msgid "Edit /etc/postfix/mysql-email2email.cf and add:" msgstr "" -#: ../../../_source/mail-libre-is.rst:365 +#: ../../../_source/mail-libre-is.rst:374 msgid "Then run these commands:" msgstr "" -#: ../../../_source/mail-libre-is.rst:382 +#: ../../../_source/mail-libre-is.rst:391 msgid "Redis" msgstr "" -#: ../../../_source/mail-libre-is.rst:383 +#: ../../../_source/mail-libre-is.rst:392 msgid "" "Note, the licensing of Redis has gone bad. The version in Debian is OK. But " "in the future, probably replace with a fork." msgstr "" -#: ../../../_source/mail-libre-is.rst:393 +#: ../../../_source/mail-libre-is.rst:402 msgid "Spam control." msgstr "" -#: ../../../_source/mail-libre-is.rst:401 +#: ../../../_source/mail-libre-is.rst:410 msgid "Certbot" msgstr "" -#: ../../../_source/mail-libre-is.rst:402 +#: ../../../_source/mail-libre-is.rst:411 msgid "" "Encryption certificates with Let's Encrypt. Not using an Apache webserver on " "the mail server makes getting new certificates a bit more complex." msgstr "" -#: ../../../_source/mail-libre-is.rst:417 +#: ../../../_source/mail-libre-is.rst:426 msgid "Just using encrypted IMAPS, not POP." msgstr "" -#: ../../../_source/mail-libre-is.rst:424 +#: ../../../_source/mail-libre-is.rst:433 msgid "" "Note, since IPv6 isn't being used, the dovecot install barfs. Edit /etc/" "dovecot/dovecot.conf and add this line, where appropriate:" msgstr "" -#: ../../../_source/mail-libre-is.rst:431 +#: ../../../_source/mail-libre-is.rst:440 msgid "" "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 \"listen\" change." msgstr "" -#: ../../../_source/mail-libre-is.rst:440 +#: ../../../_source/mail-libre-is.rst:449 msgid "Add user and set up configs" msgstr "" -#: ../../../_source/mail-libre-is.rst:468 +#: ../../../_source/mail-libre-is.rst:477 msgid "Edit /etc/dovecot/conf.d/10-master.conf and add:" msgstr "" -#: ../../../_source/mail-libre-is.rst:479 +#: ../../../_source/mail-libre-is.rst:488 msgid "" "Edit /etc/dovecot/conf.d/10-ssl.conf, set key locations, and make it " "required." msgstr "" -#: ../../../_source/mail-libre-is.rst:488 +#: ../../../_source/mail-libre-is.rst:497 msgid "" "Edit /etc/dovecot/dovecot-sql.conf.ext file and add these lines at the " "bottom, changing the password to the mailserver database password." msgstr "" -#: ../../../_source/mail-libre-is.rst:511 +#: ../../../_source/mail-libre-is.rst:520 msgid "Set file permissions." 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:" msgstr "" -#: ../../../_source/mail-libre-is.rst:531 +#: ../../../_source/mail-libre-is.rst:540 msgid "Restart dovecot server." msgstr "" -#: ../../../_source/mail-libre-is.rst:537 +#: ../../../_source/mail-libre-is.rst:546 msgid "Run this to tell postfix to deliver to dovecot:" 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:" msgstr "" -#: ../../../_source/mail-libre-is.rst:550 +#: ../../../_source/mail-libre-is.rst:559 msgid "Restart dovecot again...." msgstr "" -#: ../../../_source/mail-libre-is.rst:558 +#: ../../../_source/mail-libre-is.rst:567 msgid "More postfix" msgstr "" -#: ../../../_source/mail-libre-is.rst:559 +#: ../../../_source/mail-libre-is.rst:568 msgid "More postfix configuration, now that the above is set up." msgstr "" -#: ../../../_source/mail-libre-is.rst:561 +#: ../../../_source/mail-libre-is.rst:570 msgid "Set postfix to use dovecot for authentication:" msgstr "" -#: ../../../_source/mail-libre-is.rst:575 +#: ../../../_source/mail-libre-is.rst:584 msgid "Edit /etc/postfix/master.cf and change thusly:" msgstr "" -#: ../../../_source/mail-libre-is.rst:592 -#: ../../../_source/mail-libre-is.rst:719 +#: ../../../_source/mail-libre-is.rst:601 +#: ../../../_source/mail-libre-is.rst:728 msgid "Run:" msgstr "" -#: ../../../_source/mail-libre-is.rst:598 +#: ../../../_source/mail-libre-is.rst:607 msgid "Restart postfix:" msgstr "" -#: ../../../_source/mail-libre-is.rst:604 +#: ../../../_source/mail-libre-is.rst:613 msgid "" "Does it ever end? Edit /etc/postfix/master.cf and add to bottom of " "submission section." msgstr "" -#: ../../../_source/mail-libre-is.rst:616 +#: ../../../_source/mail-libre-is.rst:625 msgid "" "Allow aliases to send by adding this file (XXX check OK) /etc/postfix/" "aliases.cf with this contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:624 +#: ../../../_source/mail-libre-is.rst:633 msgid "Make sure all is good:" msgstr "" -#: ../../../_source/mail-libre-is.rst:632 +#: ../../../_source/mail-libre-is.rst:641 msgid "rspamd Configuration" msgstr "" -#: ../../../_source/mail-libre-is.rst:633 +#: ../../../_source/mail-libre-is.rst:642 msgid "Configure postfix for rspamd." msgstr "" -#: ../../../_source/mail-libre-is.rst:641 +#: ../../../_source/mail-libre-is.rst:650 msgid "Edit /etc/rspamd/override.d/milter_headers.conf and add:" msgstr "" -#: ../../../_source/mail-libre-is.rst:647 +#: ../../../_source/mail-libre-is.rst:656 msgid "Edit /etc/dovecot/conf.d/90-sieve.conf and change:" msgstr "" -#: ../../../_source/mail-libre-is.rst:653 +#: ../../../_source/mail-libre-is.rst:662 msgid "Create dir for new sieve filter:" msgstr "" -#: ../../../_source/mail-libre-is.rst:659 +#: ../../../_source/mail-libre-is.rst:668 msgid "" "Create /etc/dovecot/sieve-after/spam-to-folder.sieve with these contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:670 +#: ../../../_source/mail-libre-is.rst:679 msgid "Then compile it:" 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:" msgstr "" -#: ../../../_source/mail-libre-is.rst:682 +#: ../../../_source/mail-libre-is.rst:691 msgid "" "Add this /etc/rspamd/override.d/classifier-bayes.conf with below contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:688 +#: ../../../_source/mail-libre-is.rst:697 msgid "Add /etc/rspamd/local.d/classifier-bayes.conf with:" msgstr "" -#: ../../../_source/mail-libre-is.rst:694 +#: ../../../_source/mail-libre-is.rst:703 msgid "Edit /etc/dovecot/conf.d/20-imap.conf and change:" msgstr "" -#: ../../../_source/mail-libre-is.rst:700 +#: ../../../_source/mail-libre-is.rst:709 msgid "" "Edit /etc/dovecot/conf.d/90-sieve.conf and add below to \"plugins\" section:" msgstr "" -#: ../../../_source/mail-libre-is.rst:725 +#: ../../../_source/mail-libre-is.rst:734 msgid "Create /etc/dovecot/sieve/learn-spam.sieve with contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:732 +#: ../../../_source/mail-libre-is.rst:741 msgid "Create /etc/dovecot/sieve/learn-ham.sieve and add:" msgstr "" -#: ../../../_source/mail-libre-is.rst:746 +#: ../../../_source/mail-libre-is.rst:755 msgid "Run this to compile:" msgstr "" -#: ../../../_source/mail-libre-is.rst:755 +#: ../../../_source/mail-libre-is.rst:764 msgid "Create /etc/dovecot/sieve/rspamd-learn-spam.sh with contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:762 +#: ../../../_source/mail-libre-is.rst:771 msgid "Create /etc/dovecot/sieve/rspamd-learn-ham.sh with contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:769 +#: ../../../_source/mail-libre-is.rst:778 msgid "Set ownership and permissions on scripts:" msgstr "" -#: ../../../_source/mail-libre-is.rst:778 +#: ../../../_source/mail-libre-is.rst:787 msgid "Unbound" msgstr "" -#: ../../../_source/mail-libre-is.rst:779 +#: ../../../_source/mail-libre-is.rst:788 msgid "" "For proper spam filtering with rspam, unbound DNS resolver should be used." msgstr "" -#: ../../../_source/mail-libre-is.rst:785 +#: ../../../_source/mail-libre-is.rst:794 msgid "Change /etc/resolv.conf to:" msgstr "" -#: ../../../_source/mail-libre-is.rst:792 +#: ../../../_source/mail-libre-is.rst:801 msgid "Also add to /etc/rspamd/local.d/options.inc" msgstr "" -#: ../../../_source/mail-libre-is.rst:802 +#: ../../../_source/mail-libre-is.rst:811 msgid "DKIM" msgstr "" -#: ../../../_source/mail-libre-is.rst:803 +#: ../../../_source/mail-libre-is.rst:812 msgid "Set up DNS for DKIM." msgstr "" -#: ../../../_source/mail-libre-is.rst:812 +#: ../../../_source/mail-libre-is.rst:821 msgid "" "Add a 2024090101._domainkey TXT DNS record at the ISP, with contents of the " "\"p=\" and the rest, for example:" msgstr "" -#: ../../../_source/mail-libre-is.rst:819 +#: ../../../_source/mail-libre-is.rst:828 msgid "Create /etc/rspamd/local.d/dkim_signing.conf with contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:826 +#: ../../../_source/mail-libre-is.rst:835 msgid "Create /etc/rspamd/dkim_selectors.map with contents:" msgstr "" -#: ../../../_source/mail-libre-is.rst:832 +#: ../../../_source/mail-libre-is.rst:841 msgid "Restart again..." msgstr "" -#: ../../../_source/mail-libre-is.rst:838 +#: ../../../_source/mail-libre-is.rst:847 msgid "" "Take teh contents from running dkim_keygen above and add it this file: /var/" "lib/rspamd/dkim/libre.is.2024090101.key" msgstr "" -#: ../../../_source/mail-libre-is.rst:841 +#: ../../../_source/mail-libre-is.rst:850 msgid "" "Just add the PRIVATE KEY section, not the last two lines. Fix it's " "permissions:" msgstr "" -#: ../../../_source/mail-libre-is.rst:851 +#: ../../../_source/mail-libre-is.rst:860 msgid "SPF" msgstr "" -#: ../../../_source/mail-libre-is.rst:852 +#: ../../../_source/mail-libre-is.rst:861 msgid "Set up SPF." msgstr "" -#: ../../../_source/mail-libre-is.rst:854 +#: ../../../_source/mail-libre-is.rst:863 msgid "Add a DNS TXT record like this:" msgstr "" -#: ../../../_source/mail-libre-is.rst:862 +#: ../../../_source/mail-libre-is.rst:871 msgid "DMARC" 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:" 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" msgstr "" -#: ../../../_source/mail-libre-is.rst:872 +#: ../../../_source/mail-libre-is.rst:915 msgid "" "Spamhaus may automagically list the IP to be blocked when it is new. To " "remove, just go to:" msgstr "" -#: ../../../_source/mail-libre-is.rst:875 +#: ../../../_source/mail-libre-is.rst:918 msgid "``_" msgstr "" -#: ../../../_source/mail-libre-is.rst:877 +#: ../../../_source/mail-libre-is.rst:920 msgid "" "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 " diff --git a/docs/_source/mail-libre-is.rst b/docs/_source/mail-libre-is.rst index a523c8b..f47e58a 100644 --- a/docs/_source/mail-libre-is.rst +++ b/docs/_source/mail-libre-is.rst @@ -12,9 +12,22 @@ been set up and configured. Below it is how the server is set up. 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 @@ -128,12 +141,9 @@ Delete Alias Email Client Setup ================== -Set up mail clients thusly. +Set up mail clients, such as Thunderbird, thusly. - -Thunderbird ------------ -Example email Address: username@libre.is +Using example email address username@libre.is. .. code-block:: cfg @@ -153,7 +163,6 @@ Example email Address: username@libre.is Username: username@libre.is (same as email address) - 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 +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 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. Go to that link and it will be immediately removed. +