From 3ebb237a6cf07196bfcb0eb61b6549946989ca2b Mon Sep 17 00:00:00 2001
From: TillDiem <tilldieminger@freenet.de>
Date: Sun, 16 Jan 2022 13:13:46 +0100
Subject: [PATCH] Added Rainloop

---
 docs/rainloop.md | 90 ++++++++++++++++++++++++++++++++++++++++++++++++
 index.md         |  1 +
 2 files changed, 91 insertions(+)
 create mode 100644 docs/rainloop.md

diff --git a/docs/rainloop.md b/docs/rainloop.md
new file mode 100644
index 0000000..45a2614
--- /dev/null
+++ b/docs/rainloop.md
@@ -0,0 +1,90 @@
+# General
+
+[Rainloop](https://www.rainloop.net/) is a web-based email client that works with your local install of dovecot etc. Its easy to install and use.
+
+# Setting up LEMP Stack
+
+1. `apt install mariadb-server`
+2. `systemctl enable mysql`
+3. `apt install php php-fpm php-mysql -y`
+4. `systemctl enable php-fpm`
+	-  to test the php setup add
+	   ```
+	   location ~ \.php$ {
+      		include snippets/fastcgi-php.conf;
+      		fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
+		}
+	```
+	to your home site-available nginx config. Restart nginx using `systemctl restart nginx` and add a new page called `index.php` to your homepage direactory with `<?php phpinfo();?>` as the only content. If the php install worked fine, this will show you the installed php packages. Delete this afterwords.
+
+# Installing rainloop
+
+1. `apt install php7.3-{curl,xml}`
+2. `wget http://www.rainloop.net/repository/webmail/rainloop-community-latest.zip`
+3. `mkdir /var/www/html/rainloop`
+4. `unzip rainloop-community-latest.zip -d /var/www/html/rainloop/`
+5. `find /var/www/html/rainloop/ -type d -exec chmod 755 {} \;`
+6. `find /var/www/html/rainloop/ -type f -exec chmod 644 {} \;`
+7. `chown -R www-data.www-data /var/www/html/rainloop/`
+8. Edit the `nginx` entry for the webmail : `vim /etc/nginx/sites-available/rainloop.conf`. Make sure that the `php` version you installed above matches the php version in line 20. It also should match the php version of the LEMP stack. Also change the hostname accordingly.
+```sh
+	server {
+ 		listen 80;
+
+	server_name webmail.hostname.xyz;
+	root /var/www/html/rainloop;
+
+        access_log /var/log/rainloop/access.log;
+        error_log /var/log/rainloop/error.log;
+
+	index index.php;
+
+	location / {
+		try_files $uri $uri/ /index.php?$query_string;
+	}
+
+	location ~ \.php$ {
+            fastcgi_index index.php;
+            fastcgi_split_path_info ^(.+\.php)(.*)$;
+            fastcgi_keep_conn on;
+      	    fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
+            include /etc/nginx/fastcgi_params;
+            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+ 	}
+        location ~ /\.ht {
+            deny all;
+    }
+	location ^~ /data {
+	    deny all;
+	}
+}
+```
+10. `mkdir /var/log/rainloop`
+11. `nginx -t`
+12. `ln -s /etc/nginx/sites-available/rainloop.conf /etc/nginx/sites-enabled/`
+13. `systemctl reload nginx`
+
+# Configure RainLoop
+
+1. Go to `http:/webmail.hostname.xyz/?admin`. Here a webinterface should pop up (If not - ty to check the php install - all same versions? Is php accessible? Are the permissions set correctly?
+2. Log in using `admin` and `12345`. Strongly recommend to change that one as soon as you log in. This can be done under `Security` in the left menu.
+3. Under `Domains` add your local domains, ports and authentification method and delte the defaults.
+4. Now you should be able to log in to the client on `webmail.hostname.xyz` using your email adress and password.
+
+# Add database for contacts
+
+1. `mysql -uroot -p`
+2. Add a database (copy paste each single line - change `rainlooppassword` to something propper
+```sh
+
+create database rainloopdb;
+GRANT ALL PRIVILEGES ON rainloopdb.* TO 'rainloopuser'@'localhost' IDENTIFIED BY 'rainlooppassword';
+flush privileges;
+quit
+```
+3. Go to the admin panel to `Contacts` and activate the data base
+4. Select storage `mysql` and choose as DSN `mysql:host=localhost;port=3306;dbname=rainloopdb`. The user name is `rainloopuser` and the password the password you used to set up the database.
+
+# Certbot
+
+Give the webmail client proper security using `certbot --nginx` to extend your certificate.
diff --git a/index.md b/index.md
index 07f07a1..6c98190 100644
--- a/index.md
+++ b/index.md
@@ -12,6 +12,7 @@ Happy to accept pull requests for new topics!
 - [ssh](docs/ssh.md) ssh configuration
 - [GIT](docs/GIT.md) version control software
 - [neomutt](docs/neomutt.md) highly customizable TUI email client
+- [rainloop](docs/rainloop.md) Webbased email client
 
 # Admin