Skip to content

Commit

Permalink
document IMAP IDLE (Closes riseupnet#465)
Browse files Browse the repository at this point in the history
  • Loading branch information
kradan committed Sep 28, 2019
1 parent 4ce0456 commit 3d6f74e
Show file tree
Hide file tree
Showing 14 changed files with 64 additions and 25 deletions.
4 changes: 3 additions & 1 deletion pages/email/clients/apple-mail/de.text
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,16 @@ h2. OpenPGP mit Apple Mail

# Lade die letzte Version der "GPG Tools":https://gpgtools.org
# Installiere das Paket
# Danach kann GPG benutzt werden und wird integriert in Apple Mail.
# Danach kann [[opengpg]] benutzt werden und wird integriert in Apple Mail.

h1. POP-Konto erstellen

_Leider wurde dieser Abschnitt noch nicht geschrieben. "Hilf mit!":https://github.com/riseupnet/riseuphelp_

h1. IMAP-Konto erstellen

Apple Mail unterstützt [[IMAP IDLE->email/clients#imap-idle]].

_Leider wurde dieser Abschnitt noch nicht übersetzt. "Hilf mit!":https://github.com/riseupnet/riseuphelp_

h2. First Time User
Expand Down
4 changes: 3 additions & 1 deletion pages/email/clients/apple-mail/en.text
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,16 @@ h2. use OpenPGP with Apple Mail

# Download the latest "GPG Tools version":https://gpgtools.org/
# Install the package
# You'll be able to use GPG and it'll be embed with Apple Mail.
# You'll be able to use [[opengpg]] and it'll be embed with Apple Mail.

h1. Adding a POP Account

_We are sorry, but this page has not been written. "You can help to write this page":https://github.com/riseupnet/riseuphelp_

h1. Adding a New IMAP Account

Apple Mail supports [[IMAP IDLE->email/clients#imap-idle]].

h2. First Time User

<i>If you are already using mail, see "existing user":#existing-user below.</i>
Expand Down
15 changes: 8 additions & 7 deletions pages/email/clients/claws/de.text
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
@title = 'Claws'
@title = 'Claws Mail'

h2. Was ist Claws?

Expand All @@ -22,11 +22,11 @@ Beim ersten Start von Claws Mail wird dich der Einstellungs-Assistent bei der Ko
# [[Wähle den Servertyp POP3 oder IMAP->email/clients#choose-imap-or-pop]] (IMAP lässt Nachrichten auf dem Server, POP3 lädt sie herunter und löscht sie vom Server - das bedeutet IMAP ist eine gute Wahl, wenn du Mails mit mehreren Geräten abrufst und POP3 ist die etwas bessere Wahl für Privatssphäre, es ist schneller und schont deine [[Quota]])
# Wähle *mail.riseup.net* als "Serveradresse" (für IMAP und POP3)
# Gib dein Login (ohne @riseup.net) und Passwort ein
# Aktiviere *SSL für Verbindung zum empfangenden Server verwendenn* und *SSL über STARTTLS benutzen*, klick auf *Vor*
# Aktiviere *TLS für Verbindung zum empfangenden Server verwendenn* und *TLS über STARTTLS benutzen*, klick auf *Vor*
!img/setup_de_empfangen.png!
# Wähle *mail.riseup.net* als "SMTP-Serveradresse"
# Aktiviere *Benutze Authentifizierung* (die Felder für SMTP-Benutzername und Kennwort können frei bleiben)
# Aktiviere *SSL für Verbindung zum SMTP-Server benutzen* und *SSL über STARTTLS benutzen*, klick auf *Vor*
# Aktiviere *TLS für Verbindung zum SMTP-Server benutzen* und *TLS über STARTTLS benutzen*, klick auf *Vor*
!img/setup_de_senden.png!
# *Für POP3 und Tails*: Wenn du Claws Mail mit Tails benutzt, ist es wichtig, dass lokale Ordner im Persistant-Bereich gespeichert werden bevor du Mails vom Server entfernst, sonst gehen diese beim Neustart verloren! Wähle */home/amnesia/.claws-mail/Mail* als *Mailboxname*
# *Vor*, *Speichern* und fertig!
Expand All @@ -39,23 +39,24 @@ Gehe im Menu auf *Konfiguration > Neues Konto erstellen...*.
!img/einstellungen_allgemein.png!
# *Senden* - wähle *SMTP-Authentifizierung*
!img/einstellungen_senden.png!
# *SSL* - Wähle *STARTTLS* für POP3 und SMTP.
# *TLS* - Wähle *STARTTLS* für POP3 und SMTP.
!img/einstellungen_ssl.png!
# *Erweitert* - Ändere den SMTP-Port auf 587 (POP3 bleibt bei 110)
!img/einstellungen_erweitert.png!
# Klicke "OK", um die Kontoerstellung abzuschließen

h3. SSL-Zertifikate
h3. TLS-Zertifikate

Beim ersten Abrufen der Mails und beim Senden der ersten Mail siehst du ein Fenster zur Bestätigung der SSL-Verbindung. Klicke auf *Zertifikat anschauen* (die auf dem Bild angezeigt Prüfsumme könnte veraltet sein):
Beim ersten Abrufen der Mails und beim Senden der ersten Mail siehst du ein Fenster zur Bestätigung der TLS-Verbindung. Klicke auf *Zertifikat anschauen* (die auf dem Bild angezeigt Prüfsumme könnte veraltet sein):

!img/ssl.png!

Claws Mail speichert dieses Zertifikat und wird dich erst bei einer Änderungen wieder informieren. Doch Vorsicht: das könnte auf einen man-in-the-middle-Angriff hindeuten. Vergewissere dich *jedes Mal wenn dieser Dialog erscheint*, ob riseup.net dasselbe Zertifikat verwendet, indem du die angezeigte Prüfsumme [[mit der von Riseup vergleichst -> /security/network-security/certificates]]!

h3. Tails-Warnung

Wenn du Claws Mail mit Tails benutzt, ist es wichtig, dass lokale Ordner im Persistant-Bereich gespeichert werden bevor du Mails vom Server entfernst, sonst gehen diese beim Neustart verloren!
Wenn du Claws Mail mit Tails benutzt, ist es wichtig, dass lokale Ordner im Persiste
nt-Bereich gespeichert werden bevor du Mails vom Server entfernst, sonst gehen diese beim Neustart verloren!

h3. Fertig!

Expand Down
14 changes: 7 additions & 7 deletions pages/email/clients/claws/en.text
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
@title = 'Claws'
@title = 'Claws Mail'

h2. What is Claws?

Expand All @@ -21,11 +21,11 @@ The first time you run Claws Mail, the setup wizard will walk you through settin
# [[Choose server type as POP3 or IMAP -> email/clients#choose-imap-or-pop]] (IMAP leaves mail on server, POP3 downloads it locally - this means IMAP is a good choice if you have multiple machines accessing the mailbox and POP3 is a slightly better choice for privacy, the POP3 user experience is much faster and it unburdens your [[quota]])
# Enter *mail.riseup.net* for the *Server address* (both for IMAP and POP3)
# Enter your username (without @riseup.net) and password
# Select *Use SSL to connect to receiving server* and also select *Use SSL via STARTTLS*
# Select *Use TLS to connect to receiving server* and also select *Use TLS via STARTTLS*
# Click *Forward* to advance to the next screen
# Enter *mail.riseup.net* for the *SMTP server address*
# Select *Use authentication* (you can leave the SMTP username and password fields blank)
# Select *Use SSL to connect to receiving server" and also select "Use SSL via STARTTLS*
# Select *Use TLS to connect to receiving server" and also select "Use TLS via STARTTLS*
# Click *Forward* to advance to the next screen
# *If using POP3 on Tails*: For "Mailbox name" enter */home/amnesia/.claws-mail/Mail* (this step is very important for Tails users because the default Mail folder location is not-persisted between reboots) and click "Forward" to advance to the next screen
# Click *Save* to complete the process
Expand All @@ -42,7 +42,7 @@ While running Claws Mail select *Configuration > Create New Account* from the me

!img/setup_send.png!

# *SSL Settings* - Select *STARTTLS* for both POP3 and SMTP.
# *TLS Settings* - Select *STARTTLS* for both POP3 and SMTP.

!img/setup_ssl.png!

Expand All @@ -52,13 +52,13 @@ While running Claws Mail select *Configuration > Create New Account* from the me

# Click "OK" to finish adding your new account

h3. First Time, SSL Certificates
h3. First Time, TLS Certificates

When checking your mail for the first time, and also sending your first message, you will see an SSL confirmation dialog. Click *View certificate* (the fingerprint shown on the image may be outdated):
When checking your mail for the first time, and also sending your first message, you will see an TLS confirmation dialog. Click *View certificate* (the fingerprint shown on the image may be outdated):

!img/ssl.png!

On first use claws Mail will store these certificates and let you know if they ever change which may indicate an attempted man-in-the-attack, or just that riseup.net updated their certificates. *Every time* you get this SSL pop-up, [[verify the fingerprints with the ones published by Riseup -> /security/network-security/certificates#complete-verification]]]]!
On first use claws Mail will store these certificates and let you know if they ever change which may indicate an attempted man-in-the-attack, or just that riseup.net updated their certificates. *Every time* you get this TLS pop-up, [[verify the fingerprints with the ones published by Riseup -> /security/network-security/certificates#complete-verification]]]]!

h3. Tails warning

Expand Down
18 changes: 18 additions & 0 deletions pages/email/clients/de.text
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,24 @@ table(table table-striped).
| Quota | *Unbegrenzt*. Du brauchst dir niemals über quota gedanken machen, weil Nachrichten direkt auf deinen Computer geladen und danach von Server gelöscht werden. | *Begrenzt*. Es gibt [[begrenzten Speicherplatz -> quota]]. |
| Sicherheit | *Hoch*. Deine Nachrichten werden (typischerweise) nicht dauerhaft auf dem Server gespeichert. | *Niedriger*. Du betraust Riseup mit der Speicherung. |

h3. IMAP IDLE

Der [[IMAP->https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol]]-Standard unterstützt eine Erweiterung names [["IDLE"->https://en.wikipedia.org/wiki/IMAP_IDLE]], durch die ein Emailprogramm die Verbindung aufrecht erhalten und der Server bei neuen Emails, eine "push"-Meldung über die neue Nachricht an das Programm schicken kann. Dadurch kann die Email automatisch abgerufen werden und Programme müssen sich weniger "auf gut Glück" beim Server anmelden, wodurch die Last auf dem IMAP-Server sinkt. Riseup unterstützt dies. Um davon zu profitieren, wähle eines dieser Programme aus:
* [[Thunderbird]]
* [[apple-mail]], siehe [[hier->https://www.lifewire.com/instant-updates-imap-idle-os-x-1172878]]
* [[k9]], siehe [[hier->https://www.skynetbb.com/email-setup/k9-mail]]
* [[evolution]], siehe [[here->https://help.gnome.org/users/evolution/stable/mail-send-and-receive-automatically.html.en]]
* [[sylpheed]], mit einer [[Erweiterung->https://github.com/clehner/sylpheed-imap-notify]]
* [[weitere->https://github.com/search?p=2&q=%22imap+idle%22&type=Repositories]]

Es wird noch nicht unterstützt von
* iOS
* Outlook (zumindest bis Sommer 2018)
* [[offlineimap->http://www.offlineimap.org/]], [["IMAP IDLE doesn't work yet"->https://github.com/OfflineIMAP/offlineimap/blob/master/docs/offlineimap.known_issues.txt]]
* [[claws]], siehe [[Bugzilla #1408->http://www.thewildbeast.co.uk/claws-mail/bugzilla/show_bug.cgi?id=1408]]
* [[Cyrus IMAP->https://cyrusimap.org/]], siehe [[#1313->https://github.com/cyrusimap/cyrus-imapd/issues/1313]]


h2. Grundlegende Konfiguration

Auch wenn einige E-Mailprogramme sich automatisch selbst konfigurieren, benötigen die meisten einige grundlegende Informationen, um sich mit Riseup zu verbinden.
Expand Down
17 changes: 17 additions & 0 deletions pages/email/clients/en.text
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,23 @@ table(table table-striped).
| Quota | *Unlimited*. You never need to worry about quota if your client is configured to delete messages on the server after downloading. | *Limited*. You will have [[limited quota -> quota]]. |
| Security | *High*. Your messages are not stored permanently on the server (typically). | *Lower*. You are entrusting Riseup with your storage. |

h3. IMAP IDLE

The [[IMAP->https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol]] standard supports an extension named [["IDLE"->https://en.wikipedia.org/wiki/IMAP_IDLE]] where a client can keep a connection open to the server and when new mail arrives at the server it "pushes" a notification to the client that mail is waiting and it is automatically retrieved. This can speed up mail delivery quite a bit and also has the benefits of clients not needing to check mail as often and reduced resource usage on the server. Riseup's IMAP server supports it. If you want to benefit from it, you can pick one of the following email clients:
* [[Thunderbird]]
* [[apple-mail]], see [[here->https://www.lifewire.com/instant-updates-imap-idle-os-x-1172878]]
* [[k9]], see [[here->https://www.skynetbb.com/email-setup/k9-mail]]
* [[evolution]], see [[here->https://help.gnome.org/users/evolution/stable/mail-send-and-receive-automatically.html.en]]
* [[sylpheed]], with a [[plugin->https://github.com/clehner/sylpheed-imap-notify]]
* [[others->https://github.com/search?p=2&q=%22imap+idle%22&type=Repositories]]

It is not yet supported by
* iOS
* Outlook (as of summer 2018)
* [[offlineimap->http://www.offlineimap.org/]], [["IMAP IDLE doesn't work yet"->https://github.com/OfflineIMAP/offlineimap/blob/master/docs/offlineimap.known_issues.txt]]
* [[claws]], see [[Bugzilla #1408->http://www.thewildbeast.co.uk/claws-mail/bugzilla/show_bug.cgi?id=1408]]
* [[Cyrus IMAP->https://cyrusimap.org/]], see [[#1313->https://github.com/cyrusimap/cyrus-imapd/issues/1313]]

h2. Basic client configuration

Although some mail clients are able to automatically configure themselves, most require some basic information in order to connect to your Riseup email account.
Expand Down
2 changes: 1 addition & 1 deletion pages/email/clients/evolution/de.text
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ h2. Was ist Evolution?

Es wird verteilt als Teil von GNOME, wodurch es in allen Linux-Distribution mit GNOME verfügbar ist, wie ["Ubuntu":https://en.wikipedia.org/wiki/Ubuntu], und es kann per "Paketverwaltung":https://en.wikipedia.org/wiki/Package_manager deiner Distribution installiert werden. Evolution ist auch "für Windows erhältlich":https://projects-old.gnome.org/evolution/download.shtml.

Evolution enthält Unterstützung für E-Mail, Kalender, Adressbuch, Kontakte und GPG-Verschlüsselung.
Evolution enthält Unterstützung für Email, Kalender, Adressbuch, Kontakte, [[openpgp]] und [[IMAP IDLE->email/clients#imap-idle]].

h3. Evolution installieren

Expand Down
2 changes: 1 addition & 1 deletion pages/email/clients/evolution/en.text
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ h2. What is Evolution?

It is usually distributed with the GNOME Desktop Environment with linux, making it likely available either upon installation of a Linux distribution that uses GNOME, such as ["Ubuntu":https://en.wikipedia.org/wiki/Ubuntu], or available via your distribution's "Package Manager":https://en.wikipedia.org/wiki/Package_manager. Evolution is also "available for Windows":https://projects-old.gnome.org/evolution/download.shtml.

Evolution includes support for email, calendar, address book, contacts, and GPG encryption.
Evolution includes support for email, calendar, address book, contacts, [[openpgp]] and [[IMAP IDLE->email/clients#imap-idle]].

h2. Install Evolution

Expand Down
2 changes: 1 addition & 1 deletion pages/email/clients/k9/de.text
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

p(pull-right). !(image-right)K9mail.png!

[[*K-9 Mail* -> https://k9mail.github.io]] ist ein freies Emailprogramm für Android. Die Anwendung ist ein funktionalerer Ersatz für das vorinstallierte Emailprogramm der meisten Telefone. Es unterstützt POP3- und IMAP-Postfächer.
[[*K-9 Mail* -> https://k9mail.github.io]] ist ein freies Emailprogramm für Android. Die Anwendung ist ein funktionalerer Ersatz für das vorinstallierte Emailprogramm der meisten Telefone. Es unterstützt POP3- und IMAP-Postfächer, sowie [[IMAP IDLE->email/clients#imap-idle]].

K9-Mail ist sehr einfach zu konfigurieren:
# Installiere es wie oben beschrieben
Expand Down
2 changes: 1 addition & 1 deletion pages/email/clients/k9/en.text
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

p(pull-right). !(image-right)K9mail.png!

[[K-9 Mail -> https://k9mail.github.io/]] is an free software mail application for Android. The app is a more functional replacement for the default mail application included on most phones. It supports both POP3 and IMAP mailboxes.
[[K-9 Mail -> https://k9mail.github.io/]] is an free software mail application for Android. The app is a more functional replacement for the default mail application included on most phones. It supports both POP3 and IMAP mailboxes and [[IMAP IDLE->email/clients#imap-idle]].

K9-Mail is about as easy to set up as they come.

Expand Down
2 changes: 1 addition & 1 deletion pages/email/clients/sylpheed/de.text
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
@title = 'Sylpheed'

Sylpheed ist ein Freies quelloffenes (Software Libre) E-Mailprogramm für Linux/Mac/Window$. Die Anwendung ist funktionaler, leichter und ein freier Ersatz für die Standardanwendung der meisten Systeme. Es unterstützt sowohl POP3, also auch IMAP. Sylpheed unterstützt auch das Verschlüsseln und Signieren von Nachrichten. Du kannst Sylpheed von hier herunterladen: https://sylpheed.sraoss.jp/en. (Für Debian-basierte Systeme reicht @sudo apt-get install sylpheed@)
Sylpheed ist ein Freies quelloffenes (Software Libre) Emailprogramm für Linux/Mac/Window$. Die Anwendung ist funktionaler, leichter und ein freier Ersatz für die Standardanwendung der meisten Systeme. Es unterstützt sowohl POP3, also auch IMAP und [[IMAP IDLE->email/clients#imap-idle]]. Sylpheed unterstützt auch das Verschlüsseln und Signieren von Nachrichten. Du kannst Sylpheed von hier herunterladen: http://sylpheed.sraoss.jp/en. (Für Debian-basierte Systeme reicht @sudo apt-get install sylpheed@)

Sylpheed ist sehr einfach zu konfigurieren:
# Installation wie erwähnt, ansonsten siehe die Sylpheed-Dokumentation
Expand Down
2 changes: 1 addition & 1 deletion pages/email/clients/sylpheed/en.text
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
@title = 'Sylpheed'

Sylpheed is a free/libre email client for Linux/Mac/Window$. The app is a more functional, lighter, and free replacement for the default mail application included on most Systems. It supports both POP3 and IMAP mailboxes. Sylpheed also supports encrypting and signing of messages.
Sylpheed is a free/libre email client for Linux/Mac/Window$. The app is a more functional, lighter, and free replacement for the default mail application included on most Systems. It supports both POP3 and IMAP mailboxes (and [[IMAP IDLE->email/clients#imap-idle]]). Sylpheed also supports encrypting and signing of messages.

You can install Sylpheed from https://sylpheed.sraoss.jp/en. For Debian-based Linux, you can install by typing:

Expand Down
3 changes: 1 addition & 2 deletions pages/email/clients/thunderbird/de.text
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ p(pull-right). !(image-right)reclaimyourinbox.png!:https://www.thunderbird.net

Thunderbird ist das E-Mail-Programm, das Riseup Dir empfiehlt. Es ist Freie Software und erhältlich für Linux, Windows und Mac OS X. Du kannst es von der "Thunderbird-Webseite":https://www.thunderbird.net/en-US/thunderbird/all/ herunterladen. Als freie Software ist Thunderbird Teil des digitalen Allgemeinguts, einer Art gemeinsamer Schatzkammer für alle. Outlook dagegen ist Microsofts Werkzeug zur Erlangung der Weltherrschaft.

Thunderbird hat viele Funktionen, unter anderem: Unterstützung von IMAP und POP, Verwalten mehrerer Mail-Konten, eine schnelle Suche, Rechtschreibprüfung während der Eingabe, fortschrittliche Spamfilter, RSS, virtuelle Verzeichnisansichten, Nachrichtenfilter, ein integriertes Adressbuch und Unterstützung von Verschlüsselung mit OpenPGP.
Thunderbird hat viele Funktionen, unter anderem: Unterstützung von IMAP und POP, Verwalten mehrerer Mail-Konten, eine schnelle Suche, Rechtschreibprüfung während der Eingabe, fortschrittliche Spamfilter, RSS, virtuelle Verzeichnisansichten, Nachrichtenfilter, ein integriertes Adressbuch, Unterstützung von Verschlüsselung mit [[OpenPGP]] und [[IMAP IDLE->email/clients#imap-idle]].

h2. Einrichten von Thunderbird

Expand All @@ -23,7 +23,6 @@ Wenn Du Thunderbird zum ersten Mal startest, führt Dich der Kontoeinrichtungs-A

!img/konto-erstellen.png!


h3. Schritt 1

Es erscheint die Aufforderung, Deinen Namen, E-Mail-Adresse und das Passwort einzugeben.
Expand Down
2 changes: 1 addition & 1 deletion pages/email/clients/thunderbird/en.text
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ p(pull-right). !(image-right)reclaimyourinbox.png!

Thunderbird is the mail client recommended by riseup.net. It is Free Software and is available for Linux, Windows, and Mac OS X. You can download Thunderbird "from the thunderbird website":https://www.thunderbird.net/en-US/thunderbird/all/. As Free Software, Thunderbird is part of the digital commons, a kind of common treasury for all. Outlook, on the other hand, is Microsoft's tool for world domination.

Thunderbird has many features, including: IMAP and POP support, multiple accounts, quick search, spell as you type, advanced spam controls, RSS, virtual folder views, message filtering, addressbook, and support for OpenPGP encryption.
Thunderbird has many features, including: IMAP and POP support, multiple accounts, quick search, spell as you type, advanced spam controls, RSS, virtual folder views, message filtering, addressbook, support for [[OpenPGP]] encryption and [[IMAP IDLE->email/clients#imap-idle]].

h2. Setup Thunderbird

Expand Down

0 comments on commit 3d6f74e

Please sign in to comment.