===== Mail =====

(Image: New Message screen)

Connector provides a free email address for each Connector user.

If you are a //Corel Lightning// user, you selected a username when you registered for online services. This username is the basis for your Connector email address, which takes the form of username@yourdomain.joyent.net. You can immediately begin sending and receiving email with this account.  When you create new users with whom to share information in your Connector, they will be given their own email addresses based on their username.

Spam protection is provided by our Ironport spam protection hardware.

When sending messages, you can attach new files directly from your computer, and existing files you have previously added to the Files application.

===== Example =====

Email is a great way to keep in touch with people. You are planning a party for your friend Jill. Since many of your friends have email addresses, you can use email to send out invitations and receive RSVP's for Jill's party.  

===== Domain Aliasing =====
Domain aliasing is an advanced/optional feature. Whether you decide to use domain aliasing will depend on your business and/or personal requirements.  However, if you do want to use it, you will likely want to set it up early on.

The purpose of domain aliasing is to provide a more uniform and familiar way for people to access your Connector and send email to you.  Domain aliasing is a general term that includes both web address aliasing and email address aliasing.  Web address aliasing allows you to log into and use your Joyent Connector system from your own personal or business web domain, for instance, www.jillscompany.com. This works in addition to your Connector's default jillscompany.joyent.net web address. Email address aliasing allows you to send email to your own personal or business email address and it will arrive at your Connector email address.

So, for instance, if your Connector is jillscompany.joyent.net, and your email address jill@jillscompany.joyent.net, domain aliasing would allow you to access your Connector from intra.jillscompany.com, or home.jillsco.net, or whatever web domain (and prefix) you specify.  You could also send email to jill@jillscompany.com and it would go directly to jill@jillscompany.joyent.net.

Note: Other sub-domain prefixes already associated with your main domain name, such as "www." or "intranet.", will still point to their original locations.

=== HOW TO: Setting Up Domain Aliasing ===

First, contact your DNS provider to update two DNS entries:  the MX and CNAME records 
     * Have them change your MX record(s) to point to mx1.joyent.net and mx2.joyent.net (this is necessary for both email domain aliasing and web domain aliasing)
     * Have them add a CNAME record for yoursubdomain.yourdomain.com that points to yourdomain.joyent.net  [yoursubdomain= www, home, intranet, etc]
     * These changes will allow you to access your Connector from yousubdomain.yourdomain.com.  It may take up to 24 hours for these changes to propagate.

Then, set up custom Web and email domains in Connector:
  - Go to your Customer Center.  You can access it via the 'Joyent plus'  icon on upper-right of your Connector)
  - Log in; you received an email with login information when you signed up 
  - Go to the Domains tab.  Add 'yoursubdomain.yourdomain.com' in the web domain field, and add 'yourdomain.com' in the email domain field
  - If you select 'this is the primary domain,' then these settings will be the default domain settings for all users in your organization

IMPORTANT:  Make sure that you create users that have matching usernames as the existing email addresses from which you are mapping.
For example:
user1@yourdomain.com  >> user1@yourdomain.joyent.net
george.clinton@yourdomain.com  >> george.clinton@yourdomain.joyent.net
Mail sent to these users' yourdomain.com addresses should now go to their yourdomain.joyent.net users

===== Changing the ‘From’ and ‘Reply-to’ Address =====

When you create a user, the system auto-generates a default email address: username@yourdomain.joyent.net. But you can add additional email addresses to a user at any time.

You can determine the email address from which emails you send appear to be sent.  The address in the ‘From’ field of emails you send in Connector will be the address to which replies to your email will be sent.  (If you have domain aliasing or email forwarding set up for those addresses, then the replies can actually arrive in your joyent.net mailbox).

==== How to: Setting Your Primary Email Address ====

  - Click the Joyent 'plus' icon on the menu bar, and select Your Preferences
  - Scroll down to the 'email addresses' section of your contact details
  - Click the star next to the address you want to be your primary email address
  - Click Save 
  - The starred address will appear as the default ‘from’ and ‘reply-to’ address when you compose new email


==== How to:  Changing the ‘From/Reply-to’ Address in an individual email message ====

  - In the Mail application, click New
  - The ‘From’ field will default to the primary email address (see above)
  - Click the dropdown icon and select the desired ‘From’ address for the current message

===== How to: Configuring mail.app for IMAP =====

In mail.app, you may find that all your joyent.net folders appear nested under your mail.app Inbox, and that deleted, draft, and sent messages do not go to the special folders under your joyent.net account folder.

Here's how to get your Joyent folders to function like other accounts in mail.app:

To bring your joyent.net inbox out from its nested location under the mail.app inbox:

  - go to Preferences
  - select your account
  - click the Advanced tab
  - where it says IMAP Path Prefix, type INBOX
  - close Preferences, save changes
  - your Inbox and standard/smart folders should move to their 'proper' locations (with a globe/@ server icon, to indicate that they are IMAP folders)
  - you may need to close and reopen mail.app for the changes to take effect

To direct trashed, draft, sent messages into the proper folders, you must map the default mail.app folders to your Connector special folders:

  - click on the Trash folder under your joyent.net account
  - go the Mailbox > Use this Mailbox for and select Trash
  - do the same for Sent and Draft folders (unless they have been automatically mapped)
  - they will now appear below the mail.app Trash, Sent, Draft folders along with the special folders from other accounts. 
  - you will likely end up with new folders in the joyent.net section called 'Deleted Messages' and 'Sent Messages.'
  - you should delete these folders now