service/email: rewrite apple mail submission setup authored by Jérôme Charaoui's avatar Jérôme Charaoui
this was tested with ewyatt and confirmed to work on osx 14
...@@ -72,39 +72,39 @@ password. You should *NOT* get a certificate warning, a real cert ...@@ -72,39 +72,39 @@ password. You should *NOT* get a certificate warning, a real cert
## Apple Mail configuration ## Apple Mail configuration
WARNING: this configuration might not work, because Apple Mail These instructions are known to be good for OSX 14 (Sonoma). Earlier versions
actually *requires* an IMAP server for proper operation. The of Apple Mail may not expose the same settings.
configuration below *may* work, but you will probably end up sending
email through the submission server with an incorrect "envelope
from", and this will necessarily lead to delivery problems.
1. Click On "Account Information" Before configuring the outgoing SMTP server, you need to have an existing email
account configured and working, which the steps below assume is the case.
1. Open the "Accounts" settings dialog
2. On the left-hand side, select the account to associate with your
`@torproject.org` address
3. Add your `@torproject.org` address in the "Email Addresses" input field
4. Open the "Server Settings" tab
5. Click the "Outgoing Mail Account" drop-down menu and select "Edit SMTP
Server List"
6. Click the "+" sign to create a new entry:
* Description: Tor Project Submission
* User Name: (your LDAP username, e.g. in my case it is `anarcat`, **without** the `@torproject.org` part) * User Name: (your LDAP username, e.g. in my case it is `anarcat`, **without** the `@torproject.org` part)
* Password: the correct one. * Password: the correct one.
* Outgoing Mail Server (SMTP): `submission.torproject.org` * Host Name: `submission.torproject.org`
* Automatically manage connection settings: unchecked
2. Make sure that your SMTP server is set to `submission.torproject.org` * Port: 587
* Use TLS/SSL: checked
Note for existing mail users: You will need to select “Add Server” * Authentication: `Password`
from the SMTP pull-down menu.
3. If it is, select “Server Settings”
* For `Server Port`, put `465`
* Select `Use Secure Socket Layer (SSL)`
* Set `Authentication` to `Password`
* Now, enter your correct user name and your correct password.
* Select `OK`.
If your client fails to connect in the above configuration, try 7. Click OK, close the "Accounts" dialog
`STARTTLS` security on port `587` which is often open when port 465 is
blocked.
NOTE: as mentioned above, this whole guide needs to be redone, but at 8. Send a test email, ensuring to select your `@torproject.org` address is
least one user was able to add a new identity to an existing account selected in the `From:` field
by following the path "Preferences - accounts - account information -
edit email address" in Apple Mail, so not all hope is lost yet?
## Gmail configuration ## Gmail configuration
... ...
......