aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2007-10-27 12:08:32 +0200
committerJonas Smedegaard <dr@jones.dk>2007-10-27 12:08:32 +0200
commit7815f074d4042392a6abacf784b8235933df6c7d (patch)
tree8efb20d72279faf5e93c132928bf9562d6d3a6d5
parent170ddfae333cde3bd51b9704e1e5836cfd64ad1d (diff)
Major shape-up all over the site.
-rw-r--r--doc/intro.md5
-rw-r--r--doc/setup.md94
-rw-r--r--doc/use.md20
3 files changed, 80 insertions, 39 deletions
diff --git a/doc/intro.md b/doc/intro.md
index 00b1904..e409e67 100644
--- a/doc/intro.md
+++ b/doc/intro.md
@@ -1,8 +1,7 @@
# Overview of email documentation
-Each user [[account]] is an email account - with one ore more email [[addresses]] attached.
-
-The [[intro]] quickly gets you started, while [[setup]] steps through the details.
+Each user [[account]] is an email account - with one ore more email
+[[addresses]] attached.
## Setup
diff --git a/doc/setup.md b/doc/setup.md
index 7abbf28..5d65876 100644
--- a/doc/setup.md
+++ b/doc/setup.md
@@ -1,17 +1,27 @@
# Setting up your personal email account
-As a user at this system you have been given a single [[account]]. Tied to this account is an email address (or possibly more than one).
+As a user at this system you have been given a single [[account]]. Tied to this
+account is an email address (or possibly more than one).
-All incoming emails are delivered to the inbox of your personal account (ie. same location no matter if you have more addresses attached).
+All incoming emails are delivered to the inbox of your personal account (ie.
+same location no matter if you have more addresses attached).
## Webmail setup
-Webmail is probably the simplest way to reach your emails. Somewhat like HoTMaiL but without advertisements and with fewer spam mails.
+Webmail is probably the simplest way to reach your emails. Somewhat like
+HoTMaiL but without advertisements.
-One common website (contact your technicians for its location) offers several webmail applications, each with different strengths and weaknesses.
-The topmost application, IMP, is recommended, due to its most complete functionality. It provides access to changing your account [[password|password.en]].
-Same website also lists some alternative websites also offering webmail access to Homebase accounts. Save those addresses on your own computer, for the case of the primary website one day being out of order.
+One common website (contact your technicians for its location) offers several
+webmail applications, each with different strengths and weaknesses.
+
+The topmost of the webmail application, IMP, is recommended, due to its most
+complete functionality. It provides access to changing your account
+[[password]].
+
+Same website also lists some alternative websites also offering webmail access
+to accounts at this system. Save those addresses on your own computer, for the
+case of the primary webmail service one day being out of order.
Entering webmail, step by step:
@@ -22,48 +32,76 @@ Entering webmail, step by step:
## 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.
+If you have a computer of your own, it is recommended to use a "real" email
+application in favor of webmail. It works faster and is more stable. It is also
+puts less burden on the server.
+
+ 1. Download [Mozilla Thunderbird](http://www.mozilla.com/thunderbird).
- * Download [Mozilla Thunderbird](http://www.mozilla.com/thunderbird).
+ (!) Other email programs work too, but Mozilla Thunderbird is considered
+ most reliable, while still both userfriendly and
+ [free](http://en.wikipedia.org/wiki/Free_software).
- (!) Other email programs work too, but Mozilla Thunderbird is considered most reliable, while still both userfriendly and [free](http://en.wikipedia.org/wiki/Free_software).
+ 2. Create an "imap" account.
- * Create an "imap" account.
+ (!) The alternative, pop3 (suggested by default in many applications), is
+ less flexible - e.g. does not work well concurrently with webmail access to
+ your emails.
- (!) The alternative, pop3 (suggested by default in most applications), is less flexible - e.g. does not work well concurrently with webmail access to your emails.
+ 3. Use your provided username, and the hostname provided by your technicians,
+ as both incoming and outgoing server.
+ 4. Enable encryption for incoming mail (imap or pop3):
+ * Enable "SSL" (also called "secure connection")
+ 5. Enable encryption for outgoing mail (smtp):
+ 1. Enable "SSL".
+ 2. Change port number from the standard 25 to 465 (Mozilla Thunderbird does
+ this automatically)
+ 3. Enable authentication, using same username and password as for your
+ incoming mail.
- * Use your provided username, and the hostname provided by your technicians, as both incoming and outgoing server.
- * Enable encryption for incoming mail (imap or pop3):
- 1. Enable "SSL" connection (also called "secure connection")
- * Enable encryption for outgoing mail (smtp):
- 1. Enable "SSL" connection.
- 2. Change port number from the standard 25 to 465 (Mozilla Thunderbird does this automatically)
- 3. Enable authentication, using same username and password as for your incoming mail.
+ /!\ Avoid "TLS" (also called "secure *passwords*") - it does not work
+ together with SSL.
- /!\ Avoid "TLS" (also called "secure ''passwords''") - it does not work together with SSL
+Many email applications help you setting up your account using a "wizard".
+Unfortunately security setup required at this system is often left out from
+such routines.
+If you are guided by a wizard, you therefore afterwards need to manually check
+that the configuration produced match the above instructions.
-Many email applications help you setting up your account using a "wizard". Unfortunately such routines often ignores security aspects required at this system.
-So most probably you will have to first use the wizard and then manually enter "advanced settings" and enable some security options.
+/!\ Some applications stash away security options (SSL, password etc.) below
+"advanced settings" or similar.
-When you enable the improved security, the email application might complain that it does not trust the mail server.
-You then need to accept the "security certificate" used at this system (see external reference to riseup.net at the bottom of this page). This is not needed with Mozilla Thunderbird.
+Your email application might complain that it does not trust the mail server.
+You then need to accept the "security certificate" used at this system (see
+external reference to riseup.net at the bottom of this page). Mozilla
+Thunderbird need no special handling.
## Special quirks with Apple Mail
-The default setting for some versions of Apple Mail is to leave a copy of all your emails on the server, even deleted ones.
+The default setting for some versions of Apple Mail is to leave a copy of all
+your emails on the server, even when deleted in the application.
-If you use Apple Mail, you need to avoid filling up your [[allowed disk space|quota/intro.en]] by changing that behaviour:
+If you use Apple Mail, you need to avoid filling up your
+[[allowed_disk_space|quota/intro]] by changing that behaviour:
- 1. Open Mail
+ 1. Open "Mail"
2. Go to Preferences > Accounts > Advanced
- 3. Check √ 'remove copy from server after retrieving a message'
+ 3. Check "remove copy from server after retrieving a message"
## External links
-Help texts at riseup.net (whenever "mail.riseup.net" is mentioned, use the mailserver hostname of this system instead):
+The help texts at riseup.net is generally good, as their system works much like
+this. Just remember to use the mailserver hostname of this system whenever
+"mail.riseup.net" is mentioned.
* [Setting up email applications](http://help.riseup.net/mail/mail-clients/)
* [Dealing with security certificates](http://help.riseup.net/mail/security/certificates/)
* [Avoiding "leave on server" with pop3](http://www.earthnet.net/support/email/email_pop_remove_copy.htm)
+
+
+## More info
+
+ * [[Overview|mail]] of email-related info
+ * [[Overview|account]] of uses of your account
diff --git a/doc/use.md b/doc/use.md
index f4cd90c..be77bc5 100644
--- a/doc/use.md
+++ b/doc/use.md
@@ -4,7 +4,8 @@ Your account at this system has at least one email address attached.
Additional addresses can be added on request. Some may already be added.
-All incoming emails are stored in your account inbox, no matter what email address was addressed.
+All incoming emails are stored in your account inbox, no matter what email
+address was addressed.
## Webmail
@@ -20,14 +21,17 @@ This is ready to use as is - no additional setup required to get started.
Here's a short summary of the needed setup:
- * Email server is the same for both incoming and outgoing services (contact your technicians for the hostname).
- * Email are reachable through the services **pop3** and **imap**. Imap is recommended for most cases.
- * Outgoing mail is handled through secure smtp on port **465** (not the normal port 25).
- * You MUST use **SSL** and password **authentication** for all email services (also smtp).
+ * Email server is the same for both incoming and outgoing services (contact
+ your technicians for the hostname).
+ * Incoming email is reachable through **pop3** and **imap**. Imap is
+ recommended for most cases.
+ * Outgoing email is accepted through secure smtp on port **465** (not the
+ regular port 25).
+ * You MUST use password **authentication** for all email services (also smtp).
## More info
- * [[Setup]] more detailed.
- * [[Overview|mail]] of email-related info.
- * [[Overview|account]] of uses of your account.
+ * [[Setup]] more detailed
+ * [[Overview|mail]] of email-related info
+ * [[Overview|account]] of uses of your account