Add copy of http://wiki.homebase.dk/ItMailSetup.

1 files changed, 80 insertions, 0 deletions

diff --git a/doc/setup.md b/doc/setup.md
new file mode 100644
index 0000000..893b7a7
--- /dev/null
+++ b/doc/setup.md
@@ -0,0 +1,80 @@
+= Setting up your personal HomeBase email account =
+
+As a user of Homebase you have been given a single "account". Tied to this account is an email address (or perhaps more than one, especially if you are related to several of the Homebase organisations).
+
+All incoming emails are stored in the inbox of your personal account.
+
+
+== Webmail setup ==
+
+Webmail is probably the simplest way to reach your emails. Somewhat like HoTMaiL but without advertisements and with fewer spam mails.
+
+The webmail application "IMP" also gives access to change password for your Homebase account.
+
+The website https://mail.homebase.dk/ provides several webmail applications, each with different strengths and weaknesses. It also lists alternative websites also offering webmail access to Homebase accounts.
+
+ * Go to https://mail.homebase.dk/
+ * Pick the topmost webmail application, IMP.
+ * Login using your personal username and password
+
+
+== Recommended setup of local email program ==
+
+If you have a computer of your own, it is recommended to use a "real" email application instead webmail. It works faster and is more stable. It is also puts less burden on the server.
+
+ * Download [http://www.mozilla.com/thunderbird Mozilla Thunderbird].
+  . {i} Other email programs work too, but Mozilla Thunderbird is considered most reliable, while still both userfriendly and [http://en.wikipedia.org/wiki/Free_software Free].
+ * Create an "imap" account.
+  . {i} The alternative, pop3 (suggest by default in most applications), is less flexible - e.g. does not work well concurrently with webmail access to your emails.
+ * Use your provided username, and "mail.homebase.dk" as both incoming and outgoing server.
+ * Enable encryption for incoming mail (either imap or pop3):
+  1. Enable "SSL" connection.
+   . {i} Avoid "TLS" (also called "secure ''passwords''") - it does not work together with SSL
+ * Enable encryption for outgoing mail (smtp):
+  1. Enable "SSL" connection.
+   . {i} Avoid "TLS" (also called "secure ''passwords''") - it does not work together with SSL
+  2. Change port number from the standard 25 to 465
+  3. Enable authentication, using same username and password as for your incoming mail.
+
+When creating your account, you are usually guided by a "wizard". The wizard asks for the account type (imap or pop3), username and server names, but typically do not care about security. So most probably you will have to finish the wizard and afterwards go back into the detailed configuration setup and adjust to enable encryption.
+
+== Disk quota ==
+
+Your account has limited disk space. You will automatically receive warnings if you reach your "quota" limit.
+
+/!\ If you ignore quota warnings, then your account will be locked, causing emails sent to you to be rejected!
+
+Some imap email programs can be configured to show your current quota status:
+
+ * Mozilla Thunderbird:
+  1. Install the [https://addons.mozilla.org/thunderbird/881/ Display Quota] plugin.
+
+ * IMP webmail:
+  1. Choose "Layout" in the top right corner
+  2. Select "Account information" and choose "Add"
+  3. Select "Save"
+
+For info on freeing space to get below the quota limit, see ItDiskQuota.
+
+== Special quirks with Apple Mail ==
+
+You have to take some precautions when using Apple Mail as your mail reader.
+
+If you chose pop3 as mail protocol (or if you didn't choose at all - pop3 is suggested by default), then the default settings is to leave a copy of all emails on the server, also deleted ones.
+
+To avoid filling up the allowed disk space on your account (your "quota") you will need to change that behaviour:
+
+ 1. Open Mail
+ 2. Go to Preferences > Accounts > Advanced
+ 3. Check √ 'remove copy from server after retrieving a message'
+
+== External links ==
+
+Help texts at riseup.net (whenever "mail.riseup.net" is mentioned, use "mail.homebase.dk" instead):
+
+ * [http://help.riseup.net/mail/mail-clients/ Setting up email applications]
+ * [http://help.riseup.net/mail/security/certificates/ Dealing with security certificates]
+
+Avoiding "leave on server" with pop3 for various email programs:
+
+ * http://www.earthnet.net/support/email/email_pop_remove_copy.htm