Difference between revisions of "LizardMail"

From LizardWiki, FastLizard4's wiki and website
Jump to: navigation, search
(Advanced users: Settings: Add short form, fix error)
(Advanced users: Settings: Email address info)
Line 47: Line 47:
 
|- style="background:#dfd; font-weight: bold;"
 
|- style="background:#dfd; font-weight: bold;"
 
||  || IMAP || POP3 || SMTP
 
||  || IMAP || POP3 || SMTP
 +
|-
 +
| style="background:#dfd; font-weight: bold;" | Your email address
 +
| colspan="3" | ''username''@''your.ssh.login.server'' - e.g., memoryhole@phazon.fastlizard4.org<br />'''EXCEPT'''<br />If your SSH login server is ridley.fastlizard4.org; then your email address is ''username''@fastlizard4.org
 
|-
 
|-
 
| style="background:#dfd; font-weight: bold;" | Server to connect to
 
| style="background:#dfd; font-weight: bold;" | Server to connect to
| colspan="3" | ''your SSH login server''
+
| colspan="3" | ''your SSH login server, '''including''' ridley.fastlizard4.org''
 
|-
 
|-
 
| style="background:#dfd; font-weight: bold;" | Username
 
| style="background:#dfd; font-weight: bold;" | Username

Revision as of 20:31, 2 April 2013

Under construction!

This is information regarding LizardMail, the mailserver component of the LizardWiki server, which users with shell accounts on the server have access to. Each LizardWiki server has its own mail system, since unified accounts are not used.

This guide is separated into sections, depending on how you want to access the server.

Notes

  • Your email address is your account name at servername dot fastlizard4 dot org, unless your login is on ridley.fastlizard4.org, in which case it's just fastlizard4 dot org. For example, if you login to phazon.fastlizard4.org using SSH as 'thedoctor', your address would be thedoctor at phazon dot fastlizard4 dot org, and if you login to ridley.fastlizard4.org using SSH as 'themaster', your address would be themaster at fastlizard4 dot org (replace 'at' with @ and 'dot' with .).
  • Abuse of LizardMail is sufficient grounds for immediate account termination. Use of LizardMail is monitored.

From the Terminal (easiest)

  • Note that, if you are restricted to using LizardShell as your login shell (instead of, say, bash), you are severely limited in what you can do, so you might want to take the time and effort to use a mail client (i.e., the somewhat harder way; see below).

Checking mail

The easiest way to access your mail is from the terminal. Log in to the server using SSH like you normally would. After the MOTD prints, you will see either "No mail." or "You have new mail." (or similar). The latter, of course, means that you have new mail. If you have new mail, simply run the mail to check your new emails. Use the ? command in the mail viewer for some basic assistance. To check saved mails, use the command mail -f mail/Saved (you cannot yet do this if you use LizardShell). New messages that are not automatically deleted are saved when you quit the mail program.

If you are already logged into the server and a new message arrives, you should get a message that says You have new mail in /var/mail/username.

Note that it is very difficult to read HTML emails using this method, since you will see the HTML source code. To read rendered HTML emails, you must use an email client.

Sending mail

Note: At this time, LizardShell users are unable to send mail using this method.

To initiate the process, log in to the server using SSH like you normally would. Then, type the command:
mail tolist
...where tolist is a space-seperated list of email addresses you'd like to send the message to. Valid inputs for the tolist might be:

  1. example@example.com - This will send the email to example@example.com only.
  2. 'Example User <example@example.com>' - This will send the email to example@example.com only and display the destination's name, Example User, instead of just their email address. Since the spaces in this example aren't intended to separate two email addresses, the address must be surrounded with single quotes! Also note the use of angle brackets to delimit the email address itself.
  3. example@example.com example2@example.org example3@example.net - Sends an email to multiple addresses
  4. example@example.com example2@example.org 'Another Example User <example3@example.net>'

To send a message to another LizardMail address (i.e., another LizardShell user), specify their full LizardMail address - e.g., username [at] servername [dot] fastlizard4 [dot] org.

You will then be prompted for the subject of the message. Press enter after entering it. You can now type your message. Note that the message is plain-text only (no HTML). When you're done typing the message, add a blank line at the end of the message, then press <Ctrl>+<D>. You will then be prompted for CC's (carbon copies). Same format as the tolist, or just press enter if there are none. The message will then be sent. You do not need to re-enter your username or password, since you're already logged in to the server.

Before sending the message, you can abort it by pressing <Ctrl>+<C> twice.

Using an Email Client

While this method is considerably more difficult to setup than the in-terminal method, it is much more robust, easier to use after setup, and allows you to properly read HTML emails, among other things.

To use this, you'll need an email client, such as Microsoft Outlook, Microsoft Outlook Express, Evolution Mail (Linux), or Mozilla Thunderbird (the one I use and recommend). This also works with your iPhone/iPod Touch and other smartphones.

Advanced users: Settings

If you're familiar with how your email client, you may find it easier just to configure it rather than follow any step-by-step instructions below. So, here are the configuration parameters:

  • For all protocols, your username is the same as your SSH login username. Your password is the same as your SSH login password.*Each LizardNet server has its own mail system, so you need to add each server you want to check your email on as a separate account in your email program
  • Unless your email address is something@fastlizard4.org, the server you should enter into your email client to connect to is the same as the part after the @ sign in your email address. The exception is for email addresses of the form something@fastlizard4.org, or if you know that the email you want to check is on ridley.fastlizard4.org. In this case, enter your email address as something@fastlizard4.org, but instruct your email client to connect to ridley.fastlizard4.org
    • Use the same server for incoming and outgoing mail
    • Especially if you need to connect to ridley.fastlizard4.org, you may have to manually override the settings your email client chooses. Never enter just fastlizard4.org as the server to connect to, as this may accidentally direct you to the wrong server.
  • For incoming email, you may choose IMAP (recommended) or POP3 as the protocol. Outgoing should use SMTP.
  • IMAP configuration: Plain/unsecure and STARTTLS connections on port 143, SSL/TLS on 993. Use unencrypted/"normal" passwords. Because your password won't be sent encrypted itself, it is highly recommended that you either use STARTTLS or SSL/TLS to provide complete connection security. Note that most clients will choose STARTTLS or SSL/TLS by default, but it's worth checking.
  • POP3 configuration: Plain/unsecure and STARTTLS connections on port 110, SSL/TLS on 995. Use unencrypted/"normal" passwords. Because your password won't be sent encrypted itself, it is highly recommended that you either use STARTTLS or SSL/TLS to provide complete connection security. Note that most clients will choose STARTTLS or SSL/TLS by default, but it's worth checking.
  • SMTP configuration: Plain/unsecure and STARTTLS on port 587. Do not use port 25. SSL/TLS unavailable, use STARTTLS for connection encryption. Use unencrypted/"normal" passwords. Because your password won't be sent encrypted itself, it is highly recommended that you use STARTTLS to provide complete connection security. Note that most clients will choose STARTTLS by default, but it's worth checking. Note that iOS Mail's "SSL" option in SMTP configuration is actually STARTTLS, and it's enabled by default.
  • Folder layout: INBOX is your inbox (most clients figure this out automatically), Trash is your trashcan (most clients figure this out automatically), Drafts is your drafts folder (most clients figure this out automatically), Spamalot is the spam folder the server provides, Templates is your templates folder, and Sent is your sent mail folder (most clients figure this out automatically).
  • If your client has an option for it, do not use encrypted or secure login. If you're worried about privacy, connect to the server using a secure method (TLS [preferred] or SSL).
  • Login is required for SMTP
  • Please setup your client to check for new message no faster than every ten minutes.

Setup procedures for different clients may be added later. Or you can add some yourself - Log in or request an account and edit this page!

An Important Note about Certificates

The secure IMAP, POP3, and SMTP protocols all use the same certificates as the webserver. Since the authority on the certificate is LizardWiki, your mail client will probably reject or at least warn you about it. It is strongly recommended that you install our certificate (if possible; this will also increase security), else you should be ready to get some scary warnings about invalid certificates.

A Note About Combining Methods

Please note that combining the two methods for getting emails, Terminal and Email Client, can cause some very strange things to happen. For example, deleting (or moving) a message from your Inbox using IMAP in your email client will actually leave the message in the inbox file (which the mail terminal command reads) with a special deleted flag that only IMAP understands. The gist of this is that the message will appear deleted (or moved) to your email client, while to the terminal mail command, the message is still there. You can partially fix this by enabling automatic expunging of your inbox in your email client (note that this isn't supported by all email clients, notably the iPhone/iPod Touch Mail app), although this will leave behind one special message ("DON'T DELETE THIS MESSAGE -- FOLDER INTERNAL DATA") that you should not delete or move. In addition, the message displayed when you login via SSH to the server will read "You have mail" or "You have new mail", the latter indicating that new mail has actually arrived. Actually new messages are marked with a N or a U in mail's message list. If you see the "DON'T DELETE THIS MESSAGE -- FOLDER INTERNAL DATA" message, remember to note its ID number (usually 1) and to use the pre command on it (e.g., after opening mail, you see that the message's ID number is 1, so you enter the command pre 1 before anything else to preserve it).

It is therefore strongly recommended that you use one method or the other, but not both.

Note: You can also manually expunge folders within your client. Right-click the folder to expunge and look for an Expunge or Compact folder option (e.g., Thunderbird calls it Compact). Remember that this only has effect on IMAP.