computer-playbook/roles/server_docker-mailu/README.md

93 lines
2.8 KiB
Markdown
Raw Normal View History

2023-04-18 15:41:14 +02:00
# role server_docker-mailu
2020-12-27 13:22:47 +01:00
2020-12-27 19:41:35 +01:00
## setup
### bugs
#### fetchmail
Fetchmail doesn't work with big amounts of data.
For further information see this issue: https://github.com/Mailu/Mailu/issues/1719.
##### deactivation
If you have fetchmail installed and want to deinstall it keep in mind to delete all fetched accounts from the administration panel before you delete fetchmail.
##### security concerns
The [german wikipedia tells that there are some security concern with fetchmail](https://de.wikipedia.org/wiki/Fetchmail). If in the future a customer needs to functions of fetchmail, it could be better to write a docker container for [getmail](https://en.wikipedia.org/wiki/Getmail) instead because it should be more secure.
##### workaround
If you need to receive emails from another account this should help:
- Redirect to your new email account
- Export all data from your original account
- Import all data from your original account to your new account
2020-12-27 21:30:44 +01:00
2020-12-28 21:24:32 +01:00
### delete data
2020-12-28 19:09:20 +01:00
To delete all volumes and data execute:
2020-12-27 21:30:44 +01:00
```bash
2020-12-28 21:24:32 +01:00
rm -vr /etc/mailu/; docker volume rm $(docker volume ls -q | grep mailu_)
2020-12-27 21:30:44 +01:00
```
Be careful!
2020-12-27 19:41:35 +01:00
### ports
2020-12-27 13:22:47 +01:00
Keep in mind to change the conflicting ports manual.
Execute
```bash
netstat -tulpn
```
2020-12-27 16:16:12 +01:00
2020-12-27 13:22:47 +01:00
to verify that there aren't port conflicts
2020-12-27 19:41:35 +01:00
### admin account
2020-12-27 16:16:12 +01:00
Before you can use Mailu, you must create the primary administrator user account. This should be admin@{{hostname}}. Use the following command, changing PASSWORD to your liking:
```bash
2023-04-18 15:41:14 +02:00
server_docker-compose -p mailu exec admin flask mailu admin {{admin}} {{hostname}} PASSWORD
2020-12-27 16:16:12 +01:00
```
2020-12-28 21:24:32 +01:00
### cli user management
2020-12-28 16:41:01 +01:00
How to manage users is described here: https://mailu.io/master/cli.html
2020-12-27 19:41:35 +01:00
### Up
```bash
2023-04-18 15:41:14 +02:00
server_docker-compose -p mailu up -d
2020-12-27 19:41:35 +01:00
```
2021-04-05 15:42:10 +02:00
## debug
2023-04-15 13:24:21 +02:00
## database
### database access
To access the database execute
```bash
2023-04-15 17:06:10 +02:00
docker exec -it mailu-database-1 mysql -u root -D mailu -p
2023-04-15 13:24:21 +02:00
```
2021-04-05 15:42:10 +02:00
### mailu_front_1
```bash
sudo docker container exec -it mailu_front_1 /bin/bash
```
2021-08-24 22:40:59 +02:00
### restart everything
```bash
2021-08-24 22:45:25 +02:00
sudo docker restart mailu_smtp_1 mailu_imap_1 mailu_antispam_1 mailu_redis_1 mailu_webdav_1 mailu_front_1 mailu_database_1 mailu_webmail_1 mailu_admin_1 mailu_antivirus_1
2021-08-24 22:40:59 +02:00
```
2020-12-27 19:41:35 +01:00
2021-04-05 10:35:23 +02:00
## update
For update instructions follow:
- https://mailu.io/master/maintain.html
2020-12-28 16:41:01 +01:00
## todo
- https://blog.kuepper.nrw/2019/03/30/roundcube-webmail-mit-zwei-faktor-authentifizierung/
- https://mailu.io/master/faq.html#i-want-to-integrate-nextcloud-15-and-newer-with-mailu
- https://docs.nextcloud.com/server/9.0/admin_manual/configuration_user/user_auth_ftp_smb_imap.html
2020-12-27 13:22:47 +01:00
## See
- https://gist.github.com/marienfressinaud/f284a59b18aad395eb0de2d22836ae6b
- https://mailu.io/1.7/compose/setup.html
2021-08-24 18:09:58 +02:00
- https://github.com/nuxsmin/sysPass/issues/1299
- https://github.com/Mailu/Mailu/issues/1171
- https://support.plesk.com/hc/en-us/articles/115001264814-Unable-to-log-into-RoundCube-Connection-to-storage-server-failed
2023-03-26 17:05:06 +02:00
- https://github.com/Mailu/Mailu