Configuring Email Clients

All users of CS department machines are provided an email address upon account creation. Below you will find information on configuring various email clients for Linux, Windows and Mac. The default email address is username@cs.uky.edu, if you have other requirements please send a request to help@cs.uky.edu.


Android

  1. Step 1

    • Navigate to the “Email” application, or select ‘Add account’ in the Settings Application, that will bring you to the screen above.

    • In the first field, enter your email address, which is your CS account username @cs.uky.edu.

    • Enter your CS account password. Note: this is not your LinkBlue password (unless it is…)

    • Tap Next

      step 1
  2. Step 2

    • Select IMAP

      step 2
  3. Step 3

    • In the username field, it will have your full email address filled in, delete the @cs.uky.edu part so it is just your username.:

      Mail Server: mail.cs.uky.edu
      Port: 993
      Security type: SSL/TLS (Accept all certificates)
      Leave the IMAP path prefix field blank
      
    • Tap Next

      step 3
  4. Step 4

    • Use the following settings for SMTP:

      SMTP server: mail.cs.uky.edu
      Port: 587
      Security type: STARTTLS (Accept all certificates)
      
    • If Require signin is not checked, check it and enter your username (without @cs.uky.edu) and password.

      step 4
  5. Step 5

    • These settings are your personal preference, however, note that a slower check frequency will use less battery.

    • Tap Next

      step 5
  6. Step 6

    • Give the account a name, e.g. ‘CS Mail’

    • Your name will probably already be filled in.

    • Tap Next, and you’re done!

      step 6

iOS

  1. Step 1

    • Select Mail, Contacts, Calendars from the Settings app.

      step 1
  2. Step 2

    • Select Add Account.

      step 2
  3. Step 3

    • Choose Other at the bottom of the list.

      step 3
  4. Step 4

    • Select Add Mail Account.

      step 4
  5. Step 5

    • Enter your name as you want others to see it.

    • Enter your email address, which is your CS account username @cs.uky.edu.

    • Enter your CS account password, note this is not your LinkBlue password.

    • Enter a description for the account, e.g. CS Email.

    • Tap Next.

      step 5
  6. Step 6

    • Make sure IMAP is highlighted at the top of the screen.

    • Name, Email and Description should already be filled in with the information from the previous page.

    • Scroll down to Incoming Mail settings.

      step 6
  7. Step 7

    • Host Name: mail.cs.uky.edu.

    • User Name: your CS account username.

    • Password should already be filled in.

    • Scroll down to Outgoing Mail settings.

      step 7
  8. Step 8

    • Hostname: mail.cs.uky.edu.

    • Username: your CS account username.

    • Password: the same password you entered before, your CS account password.

      step 8
  9. Step 9

    • All that matters here is that you leave Mail turned on, otherwise you won’t receive email.

    • Synchronizing Notes is optional.

    • Tap Save and you’re done!.

      step 9

Mozilla Thunderbird

  1. Step 1

    • Open the Thunderbird Mail application, which will bring you to the first pop-up screen.

    • Click “Skip this and use my existing email” to proceed.

      step 1
  2. Step 2

    • After completing step 1, you will be presented with the screen on the right.

    • In the first field, enter your first and last name.

    • In the second field, enter your email address, which is your cs account username, followed by @cs.uky.edu (i.e myusername@cs.uky.edu).

    • In the third field, Enter the password associated with your CS account.

    • Tap continue.

      step 2
  3. Step 3

    • Click Manual config in the bottom left hand corner of the window. Note that you do not need to wait for thunderbirds search process to finish, as thunderbird cannot proceed until we enter the required information in manual config. Clicking manual config, presents you with the following screen.

    • First, enter the appropriate information for the Incoming: line. Also make sure that IMAP is selected in the first box on this line.:

      Server hostname: mail.cs.uky.edu
      Port: 993
      SSL: SSL/TLS
      Authentication: Autodetect
      
    • Next, enter the appropriate information for the Outgoing: line.:

      Server hostname: mail.cs.uky.edu
      Port: 587
      SSL: STARTTLS
      Authentication: Autodetect
      
    • Lastly, make sure your username is in both boxes on the third line labeled “Username:” and then tap “re-test”.

      step 3
  4. Step 4

    • If the test completes successfully, then go ahead and tap Done.

    • Finally, when prompted with the screen on the right, go ahead and click Confirm Security Exception to finalize your setup, and your done!

    • Please Note that the first time you send a message with your account, a similar security prompt will pop up in the background. Just click Confirm Security Exception a second time, to be able to send mail.

      step 4

Outlook

  1. Step 1

    • After opening the outlook application, enter your cs username without @cs.uky.edu, (i.e myusername where your email address is myusername@cs.uky.edu) and underneath the advanced options bar, select “Let me set up my account manually”.

      step 1
  2. Step 2

    • On the next menu be sure to select IMAP.

      step 2
  3. Step 3

    • Now fill in all the required information into their respective boxes.

      Incoming mail:

      Server: mail.cs.uky.edu
      Port: 993
      Encryption Method: SSL/TLS
      

      Outgoing mail:

      Server: mail.cs.uky.edu
      Port: 587
      Encryption Method: STARTTLS
      
    • Make sure to check “Require logon using Secure Password Authentication” for outgoing mail only.

      step 3
  4. Step 4

    • Outlook will now attempt to connect to the server and test, if it is successful it will automatically proceed to the next screen.

    • On the final screen, uncheck the box that asks you to set up outlook on your mobile phone, and click OK to proceed, and your done!

      step 4

Apple Mail

  1. Step 1

    • Open the Mail application, select Mail->Accounts and select the bottom one “Add Other Account”.

    • Select “Add a Mail Account” and click Create.

    • In the fields, enter your name, email address, which is your CS account username @cs.uky.edu

    • Enter your CS account password, note this is not your LinkBlue password.

    • Click Create

    • Upon Discovering settings hit Next when it enables

      step 1
  2. Step 2

    • Select IMAP
    • Mail server: mail.cs.uky.edu
    • User name: your_username
    • Password: your_password

    • Click Next

    • It will state “Signing in….”

      step 2
  3. Step 3

    • If that fails, you may have to give more info:

    • Leave the IMAP path prefix field blank

    • Port: 993

    • Check Use SSL

    • Authentication: Password

      step 3
  4. Step 4

    • SMTP server: mail.cs.uky.edu
    • User name: your_username
    • Password: your_password

    • Click Create

    • Port: 587

    • Security type: STARTTLS (Accept all certificates)

    • If Require signin is not checked, check it and enter your username and password

      step 4
  5. Step 5

    • If that fails, you may have to give more info:

    • Port: 587

    • Authentication: Password

      step 5

Mutt

Per the Mutt web site -

Mutt is a small but very powerful text-based mail client for Unix and Unix like operating systems.

Note

This document uses the standard conventions for running commands. A command that begins with # is to be run as the superuser and commands that are to be run as a standard user account begin with $.

Mutt can be installed on Ubuntu via # apt-get install mutt and on MacOS with homebrew by running $ brew install mutt.

We will be using GPG encryption to store your password. You will need to install it as well, on Ubuntu run # apt-get install gnupg2 and on MacOS run $ brew install gpg.

Generate a GPG key by running $ gpg --full-gen-key.

Note

Some versions of GPG use the command gpg2 in place of gpg. The commands are the same otherwise. If your system uses gpg2 be sure to modify the command used to decrypt the password in the below configuration.

Use the defaults for the kind of key and keysize and set the key to never expire then enter in your personal information when setting up the user ID. The Real Name should be both first and last name and the comment section can be anything you like, i.e. mail password key.

To encrypt the password run the following command:

$ echo "password" | gpg --encrypt --recipient "Real Name" -o ~/.mutt/accounts/mail-passwd.gpg

Where password is your cs account password and Real Name is your Real Name used when you generated your key in the step above.

Warning

The GPG version on Ubuntu has not been tested at this time.

Once the above task are complete, create .muttrc in your favorite text editor, e.g. $ vi ~/.muttrc, and add the following:

# Personal Information
set from = "username@cs.uky.edu"
set realname = "Firstname Lastname"

# Credentials **Remember to change gpg to gpg2 if your system uses that command**
set crypt_pass = "`gpg --quiet --for-your-eyes-only -d ~/.mutt/accounts/mail-passwd.gpg`"
set imap_user = "username"
set imap_pass = $crypt_pass
set smtp_url = "smtp://username@mail.cs.uky.edu:587/"
set smtp_pass = $crypt_pass

# Mailboxes
set folder = "imaps://mail.cs.uky.edu:993"
set spoolfile = "+INBOX"

# Storage Location
set postponed = +[mail]/Drafts
set header_cache = ~/.mutt/cache/headers
set message_cachedir = ~/.mutt/cache/bodies
set certificate_file = ~/.mutt/certificates

# Etc
set move = no
set mail_check = 30
set sort = threads
set editor = "vim"
set smtp_authenticators = 'gssapi:login'

# To add a signature to your emails, create it in ~/.signature and uncomment the following
#set signature="~/.signature"
# GnuPG bootstrap - you will know if you need to use this
#source ~/.mutt/gpg.rc

Attention

You will be prompted to enter the decrption password upon startup of mutt.

The first time you run mutt it will install the certificate and prompt for confirmation, hit a to select “(a)ccept always” and allow the certificate to be permanently accepted.

Note

You will get an error message that the certificate could not be saved, it is safe to ignore this message, the next time you run mutt it will save the cert.

For more information on using mutt please see the official mutt website - http://www.mutt.org.