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 `` 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