mirror of
https://github.com/AlexBocken/mykb.git
synced 2024-11-22 03:09:37 +01:00
106 lines
4.0 KiB
Markdown
106 lines
4.0 KiB
Markdown
# 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 php7.3-fpm php7.3-mysql -y`
|
|
4. `systemctl enable php7.3-fpm` To test the php setup add the following to your site-available nginx folder. Restart nginx using `systemctl restart nginx` and add a new page called `index.php` to your homepage directory with `<?php phpinfo();?>` as the only content. If the php install worked fine, this will show you the installed php packages. Delete this afterwords.
|
|
|
|
|
|
|
|
```
|
|
location ~ \.php$ {
|
|
include snippets/fastcgi-php.conf;
|
|
fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
|
|
}
|
|
```
|
|
|
|
# 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 authentication method and delete the defaults.
|
|
4. Now you should be able to log in to the client on `webmail.hostname.xyz` using your email address and password.
|
|
|
|
# Add database for contacts
|
|
|
|
1. `mysql -uroot -p`
|
|
2. Add a database (copy paste each single line - change `rainlooppassword` to something proper
|
|
```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.
|
|
|
|
# Increasing the upload limit
|
|
|
|
To increase the maximal upload through the rainloop interface to 100 MB, we do:
|
|
|
|
1. `vim /etc/php/7.3/fpm/php.ini`
|
|
- Set `upload_max_filesize` to `100M`
|
|
- Set `post_max_size` to `100M`
|
|
2. `systemctl restart php7.3-fpm`
|
|
3. `vim /etc/nginx/nginx.conf`
|
|
- Set `client_max_body_size` to `100M`
|
|
4. `systemctl restart nginx`
|
|
5. Go to `http:/webmail.hostname.xyz/?admin` and under `General` set `Upload size limit` to `100M`
|
|
- Here you can also see if the php settings worked out.
|