Merge branch 'getmail' of lugubris/wiki into master

articles/wiki/email.md

@@ -8,7 +8,7 @@ Your email can be accessed in one of three ways:
 
 1. Running the Mutt or Alpine email clients through your SSH account
 2. Logging into your email account from our [Rainloop web mail](https://www.thunix.net/webmail/) service
-3. Through an email client program installed on your computer, using IMAP
+3. Through an email client program installed on your computer, using IMAP or POP
 
 Unlike the email services provided by Microsoft, Yahoo, Google and other providers, who intrusively spy on its users beyond reasonable law enforcement and advertising tactics, thunix email services will always respect user privacy, as you can see through our [GDPR Statement and Privacy Policy](https://www.thunix.net/gdpr).
 

articles/wiki/unsorted/lugubris/getmail.md

@@ -0,0 +1,43 @@
+## getmail
+
+---
+
+getmail is a mail retriever designed to allow you to get your mail from one or more mail accounts on various mail servers to your local machine for reading with a minimum of fuss. getmail is designed to be secure, flexible, reliable, and easy-to-use.
+
+### Configuration
+
+- Create a file under .getmail in your home directory (Default: .getmail/getmailrc)
+
+#### Retrieving email
+
+Here is an example configuration file used with a thunix account:
+
+```
+[retriever]
+type = SimplePOP3SSLRetriever
+server = thunix.net
+username = user
+port = 995
+password_command = ("/path/to/password-retriever", "-p", "myaccount@thunix.net")
+
+[destination]
+type = Maildir
+path = ~/Maildir/inbox/
+``
+
+If the default filename (getmailrc) is not used then one can retrieve email by executing `$ getmail --rcfile thunix`, replace thunix with the filename used.
+
+#### Password management
+
+Passwords can be directly stored in the config file instead of using an external password retriever. To store password in config file use "password" parameter:
+
+```
+password = correct horse battery staple
+```
+
+This is not recommended, you should instead use an external retriever if possible. If "password" parameter is used then users should set right permission for ".getmail" directory, use `$ mkdir -m 0700 ~/.getmail` to create the directory.
+
+### Related
+
+- [getmail documentation](http://pyropus.ca/software/getmail/)
+- [getmail - Arch Wiki](https://wiki.archlinux.org/index.php/Getmail)