Commit e1a168

2026-11-04 06:56:04 Dave LeBlanc: Added Webmail on Wed Nov 4 06:53:47 2026
main/how to read cms email.md ..
@@ 1,73 1,64 @@
# How to read CMS email
----++ How To Configure an IMAP Client to Read/Send CMS Email
+## How To Configure an IMAP Client to Read/Send CMS Email
-This document assumes that you're reading your username@cms.caltech.edu email, and you're using it as your primary communication channel for business related to the Institute.
+This document assumes that you're reading your `username@cms.caltech.edu` email, and you're using it as your primary communication channel for business related to the Institute.
-By default, when CMS accounts are created, we forward your email to a destination address (usually your username@caltech.edu email address). However, for various reasons, some folks prefer to use their username@cms.caltech.edu address. While your user@caltech.edu address goes away when you leave the institute, your CMS email address can persist as a legacy forward.
+By default, when CMS accounts are created, your email is forwarded to a destination address (usually your `username@caltech.edu` email address). However, for various reasons, some folks prefer to use their `username@cms.caltech.edu` address. While your `user@caltech.edu` address goes away when you leave the institute, your CMS email address can persist as a legacy forward.
-If you are going to publish your user@caltech.edu email address as your primary address, you should use that in the Caltech directory and on any other documents that require an email address, and simply don't use or publish your user@cms.caltech.edu email.
+If you are going to publish your `user@caltech.edu` email address as your primary address, you should use that in the [Caltech directory](https://directory.caltech.edu) and on any other documents that require an email address, and simply don't use or publish your `user@cms.caltech.edu` email.
-Note: We *do not recommend* relying upon mail forwards for normal mail delivery. In the good ol' days, you could bounce email through several waypoints, forwarding email from one account to another. With the increasing volumes of spam over the years, mail server administrators have been forced to take more and more additional steps to lock down email to prevent systems from being flooded with spam. New antispam measures do sender-domain checks, Bayesian filters are triggered by "from" addresses not matching the sender address, and there are other countermeasures that make it more likely that legitimate mail will be flagged as spam somewhere along the delivery path. If you forward CMS email to some other destination, it has to pass through not only our spam scanning service but the spam scanning service of whatever destination address you use, which means misplaced mail can be misplaced in two different spam fitlers, etc.
+> [!Note]
+> We *do not recommend* relying upon mail forwards for normal mail delivery.
+> In the good ol' days, you could bounce email through several waypoints, forwarding email from one account to another.
+> With the increasing volumes of spam over the years, mail server administrators have been forced to take increasingly more steps to lock down email to prevent systems from being flooded with spam.
+> New antispam measures do sender-domain checks, Bayesian filters are triggered by "from" addresses not matching the sender address, and there are other countermeasures that make it more likely that legitimate mail will be flagged as spam somewhere along the delivery path.
+> If you forward CMS email to some other destination, it has to pass through not only our spam scanning service but the spam scanning service of whatever destination address you use, which means misplaced mail can be misplaced in two different spam fitlers, etc.
-Now...
+If you're using CMS infrastructure, we recommend a fully standards-compliant IMAP client.
+The most common freeware version is [Mozilla Thunderbird](https://www.thunderbird.net/en-US/), so the directions below are for that email client.
+With small alterations they should work with most email clients available on Windows, Mac, Linux, or on mobile devices such as Android, or an iPhone.
-If you're using CMS infrastructure, we recommend a fully standards-compliant IMAP client. The most common freeware version is Mozilla Thunderbird, so the directions below are for that email client. With small alterations they should work with most email clients available on Windows, Mac, Linux, or on mobile devices such as Android, or an iPhone.
----++++ Step One:
+#### Step One
+Download and install [Thunderbird](https://www.thunderbird.net/en-US/).
+Make sure you get it from the Mozilla Foundation and not from another source, which may have adware installed.
-Download and install [[https://www.thunderbird.net/en-US/][Thunderbird]]. Make sure you get it from the Mozilla Foundation and not from another source, which may have adware installed.
----++++ Step Two:
+#### Step Two
+Run the Installer, and at the end of the installation process choose ***Launch Thunderbird now***.
-Run the Installer, and at the end of the installation process choose "Launch Thunderbird now". You will see the default Thunderbird window, along with a pop up window like this one:
+We used to include helpful screenshots to guide new users, but Mozilla has since completely redesigned the interface, and it is much less sustainable to re-capture screenshots for every version of Thunderbird, whenever Mozilla decides to revamp the UI.
-<img alt='Thunderbird Popup Window #1' border='b' height='460' src='%ATTACHURL%/One.jpg' width='580' />
----+++ Step Three:
+Instead, here are the important bits that you need to know, to configure Thunderbird.
-You'll have to enter your name and email address. Once you do, the "Manual config" button will be enabled:
+ * **Your email address**: `<user>@cms.caltech.edu`, where `<user>` is the username you've been assigned.
+ * **Your password**: This is the password that is associated with your username (above) when your account was created, or changed recently by you.
-<img alt='' height='460' src='%ATTACHURL%/Two.jpg' width='586' />
-Clicking on the "Manual config" button expands the window and enables you to fill out all of the relevant fields.
----++++ Step Four:
+ * **Incoming mail server**: `imap.cms.caltech.edu`
+ * Server _port_: `143`
+ * SSL/TLS: `STARTTLS`
+ * Authentication: `Normal Password`
-You want to fill out that window as below, substituting in your name and your CMS account name where appropriate:
+ * **Outgoing mail server**: `mailhost.cms.caltech.edu`
+ * Server _port_: `587`
+ * SSL/TLS: `STARTTLS`
+ * Authentication: `Normal Password`
-<img alt='' height='460' src='%ATTACHURL%/Three.jpg' width='939' />
+#### Step Three
+After feeding the above information into Thunderbird, you may see a dialog window that appears to be similar to below:
-(The configuration information shown above is the relevant infomation for a phone client or other desktop email client. The incoming server is an IMAP server, named "imap.cms.caltech.edu", listening on port 143, with the STARTTLS encryption mechanism. The outgoing server is an SMTP server, named "mailhost.cms.caltech.edu", listening on port 587, also with the STARTTLS encryption mechanism.)
+{{Figure
+|caption=Add Security Exception
+|align=left
+|width=40%
+![](https://info-4.cms.caltech.edu/Main/How%20to%20read%20CMS%20email/Four.jpg)
+}}
-After you've entered in the information above, hit the "Done" button. This will take you back to the regular Thunderbird screen, and you will see your Inbox, but without any messages yet.
----++++ Step Five:
+Not to worry!
+This is a remnant from when Mozilla relied on well known commercial Certificate Authorities to provide a known identifyable Root CA. CMS does not have a Root CA, because we use certificates for free from [Lets Encrypt](https://letsencrypt.org).
-Click on the "Get Messages" button to start your first connection to the mail server.
+You may safely view, and confirm the identity of the certificate, but you must check **Permanently store this exception** and then **Confirm Security Exception** to be able to read CMS email.
-When you do, this window will appear:
-
-<img alt='' height='450' src='%ATTACHURL%/Four.jpg' width='597' />
-
-CMS uses a self-signed SSL certificate for both incoming and outgoing email (we do this to avoid paying Verisign or another Certificate Authority for a CA-signed cert). Although this window looks scary, this is expected.
----++++ Step Six:
-
-Click on the "Confirm Security Exception" button, and Thunderbird will prompt you for your password:
-
-<img alt='' height='211' src='%ATTACHURL%/Five.jpg' width='453' />
-
-Type in your CMS password (click the box to have the Password Manager remember it if you don't want Thunderbird to ask you every time you get email), and hit "OK".
-
-Once your email Inbox syncs, you need to send yourself a test email to finish configuring outgoing email.
----++++ Step Seven:
-
-Click on "Write", and compose yourself a short email, addressing it to your CMS email address. Hit "Send". When you do, this window will pop up (warning, some editions of Thunderbird this window pops up *behind* the main window, and you'll have to shrink the Thunderbird window to see it):
-
-<img alt='' height='451' src='%ATTACHURL%/Six.jpg' width='598' />
-
-Again, hit "Confirm Security Exception" to save the certificate in your certificate store.
-
-This will return you to the main screen.
----++++ Step Eight:
-
-You may or may not see this pop up:
-
-<img alt='' height='167' src='%ATTACHURL%/Seven.jpg' width='614' />
-
-If you do, just hit "OK" and then hit "Send" on the email again. The message should sail through, and wind up back in your Inbox.
+## Webmail
+Another choice is to forego the software and just use [CMS Webmail](https://webmail.cms.caltech.edu).
+Here, most things are already configured for you already, as the mail server connections are pre-configured by default.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9