Gnous/mailcow
2
0
Fork 0
Code Issues Pull Requests 1 Packages Projects Releases Wiki Activity

Merge branch 'master' of https://github.com/andryyy/mailcow-dockerized

Browse Source 
Conflicts:
	docs/u_and_e.md
This commit is contained in:
andryyy 2017-03-07 09:30:49 +01:00
commit 5c40d84e78
1 changed files with 84 additions and 80 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

164
docs/u_and_e.md
View File

@ -38,9 +38,10 @@ cd /path/to/mailcow-dockerized
source mailcow.conf source mailcow.conf
DATE=$(date +"%Y%m%d_%H%M%S") DATE=$(date +"%Y%m%d_%H%M%S")
docker run --rm -it -v $(docker inspect --format '{{ range .Mounts }}{{ if eq .Destination "/var/vmail" }}{{ .Name }}{{ end }}{{ end }}' $(docker-compose ps -q dovecot-mailcow)):/vmail -v ${PWD}:/backup debian:jessie tar xvfz /backup/backup_vmail.tar.gz docker run --rm -it -v $(docker inspect --format '{{ range .Mounts }}{{ if eq .Destination "/var/vmail" }}{{ .Name }}{{ end }}{{ end }}' $(docker-compose ps -q dovecot-mailcow)):/vmail -v ${PWD}:/backup debian:jessie tar xvfz /backup/backup_vmail.tar.gz
``` ```
## Docker Compose Bash completion ## Docker Compose Bash completion
For the tab-tab... :-) For the tab-tab... :-)
``` ```
@ -51,6 +52,7 @@ curl -L https://raw.githubusercontent.com/docker/compose/$(docker-compose versio
Edit a domain as (domain) administrator to add an item to the filter table. Edit a domain as (domain) administrator to add an item to the filter table.
Beware that a mailbox user can login to mailcow and override a domain policy filter item. Beware that a mailbox user can login to mailcow and override a domain policy filter item.
<<<<<<< HEAD
## Change default language ## Change default language
@ -61,7 +63,6 @@ Create a file `data/web/inc/vars.local.inc.php` and add "DEFAULT_LANG" with eith
<?php <?php
$DEFAULT_LANG = "de"; $DEFAULT_LANG = "de";
``` ```
## Change UI theme ## Change UI theme
mailcow uses [Bootstrap](http://getbootstrap.com/), a HTML, CSS, and JS framework. mailcow uses [Bootstrap](http://getbootstrap.com/), a HTML, CSS, and JS framework.
@ -85,7 +86,7 @@ Now auto-recreate modified containers:
docker-compose up -d docker-compose up -d
``` ```
## Disable sender addresses verification ## Disable sender addresses verification
This option is not best-practice and should only be implemented when there is no other option available to archive whatever you are trying to do. This option is not best-practice and should only be implemented when there is no other option available to archive whatever you are trying to do.
@ -105,7 +106,7 @@ Run postmap on check_sasl_access:
docker-compose exec postfix-mailcow postmap /opt/postfix/conf/check_sasl_access docker-compose exec postfix-mailcow postmap /opt/postfix/conf/check_sasl_access
``` ```
Restart the Postfix container. Restart the Postfix container.
## Install Roundcube ## Install Roundcube
@ -163,7 +164,7 @@ Initialize the database and leave the installer.
### Enable change password function in Roundcube ### Enable change password function in Roundcube
Open `data/web/rc/config.inc.php` and enable the password plugin: Open `data/web/rc/config/config.inc.php` and enable the password plugin:
``` ```
... ...
@ -244,7 +245,7 @@ Restart the stack, changed containers will be updated:
`docker-compose up -d` `docker-compose up -d`
## Redis ## Redis
### Client ### Client
@ -252,7 +253,7 @@ Restart the stack, changed containers will be updated:
docker-compose exec redis-mailcow redis-cli docker-compose exec redis-mailcow redis-cli
``` ```
## Remove persistent data ## Remove persistent data
- Remove volume `mysql-vol-1` to remove all MySQL data. - Remove volume `mysql-vol-1` to remove all MySQL data.
- Remove volume `redis-vol-1` to remove all Redis data. - Remove volume `redis-vol-1` to remove all Redis data.
@ -271,7 +272,7 @@ source mailcow.conf
docker-compose exec mysql-mailcow mysql -u${DBUSER} -p${DBPASS} ${DBNAME} -e "DROP TABLE admin;" docker-compose exec mysql-mailcow mysql -u${DBUSER} -p${DBPASS} ${DBNAME} -e "DROP TABLE admin;"
``` ```
2\. Open mailcow UI to auto-init the db 2\. Open mailcow UI to auto-init the db
## Rspamd ## Rspamd
@ -296,86 +297,88 @@ docker-compose exec rspamd-mailcow rspamadm --help
See [Rspamd documentation](https://rspamd.com/doc/index.html) See [Rspamd documentation](https://rspamd.com/doc/index.html)
## Adjust service configurations ## Adjust service configurations
The most important configuration files are mounted from the host into the related containers:
The most important configuration files are mounted from the host into the related containers:
``` ```
data/conf data/conf
├── bind9 ├── bind9
│   └── named.conf │   └── named.conf
├── dovecot ├── dovecot
│   ├── dovecot.conf │   ├── dovecot.conf
│   ├── dovecot-master.passwd │   ├── dovecot-master.passwd
│   ├── sieve_after │   ├── sieve_after
│   └── sql │   └── sql
│   ├── dovecot-dict-sql.conf │   ├── dovecot-dict-sql.conf
│   └── dovecot-mysql.conf │   └── dovecot-mysql.conf
├── mysql ├── mysql
│   └── my.cnf │   └── my.cnf
├── nginx ├── nginx
│   ├── dynmaps.conf │   ├── dynmaps.conf
│   ├── site.conf │   ├── site.conf
│   └── templates │   └── templates
│   ├── listen_plain.template │   ├── listen_plain.template
│   ├── listen_ssl.template │   ├── listen_ssl.template
│   └── server_name.template │   └── server_name.template
├── pdns ├── pdns
│   ├── pdns_custom.lua │   ├── pdns_custom.lua
│   └── recursor.conf │   └── recursor.conf
├── postfix ├── postfix
│   ├── main.cf │   ├── main.cf
│   ├── master.cf │   ├── master.cf
│   ├── postscreen_access.cidr │   ├── postscreen_access.cidr
│   ├── smtp_dsn_filter │   ├── smtp_dsn_filter
│   └── sql │   └── sql
│   ├── mysql_relay_recipient_maps.cf │   ├── mysql_relay_recipient_maps.cf
│   ├── mysql_tls_enforce_in_policy.cf │   ├── mysql_tls_enforce_in_policy.cf
│   ├── mysql_tls_enforce_out_policy.cf │   ├── mysql_tls_enforce_out_policy.cf
│   ├── mysql_virtual_alias_domain_catchall_maps.cf │   ├── mysql_virtual_alias_domain_catchall_maps.cf
│   ├── mysql_virtual_alias_domain_maps.cf │   ├── mysql_virtual_alias_domain_maps.cf
│   ├── mysql_virtual_alias_maps.cf │   ├── mysql_virtual_alias_maps.cf
│   ├── mysql_virtual_domains_maps.cf │   ├── mysql_virtual_domains_maps.cf
│   ├── mysql_virtual_mailbox_maps.cf │   ├── mysql_virtual_mailbox_maps.cf
│   ├── mysql_virtual_relay_domain_maps.cf │   ├── mysql_virtual_relay_domain_maps.cf
│   ├── mysql_virtual_sender_acl.cf │   ├── mysql_virtual_sender_acl.cf
│   └── mysql_virtual_spamalias_maps.cf │   └── mysql_virtual_spamalias_maps.cf
├── rmilter ├── rmilter
│   └── rmilter.conf │   └── rmilter.conf
├── rspamd ├── rspamd
│   ├── dynmaps │   ├── dynmaps
│   │   ├── authoritative.php │   │   ├── authoritative.php
│   │   ├── settings.php │   │   ├── settings.php
│   │   ├── tags.php │   │   ├── tags.php
│   │   └── vars.inc.php -> ../../../web/inc/vars.inc.php │   │   └── vars.inc.php -> ../../../web/inc/vars.inc.php
│   ├── local.d │   ├── local.d
│   │   ├── dkim.conf │   │   ├── dkim.conf
│   │   ├── metrics.conf │   │   ├── metrics.conf
│   │   ├── options.inc │   │   ├── options.inc
│   │   ├── redis.conf │   │   ├── redis.conf
│   │   ├── rspamd.conf.local │   │   ├── rspamd.conf.local
│   │   └── statistic.conf │   │   └── statistic.conf
│   ├── lua │   ├── lua
│   │   └── rspamd.local.lua │   │   └── rspamd.local.lua
│   └── override.d │   └── override.d
│   ├── logging.inc │   ├── logging.inc
│   ├── worker-controller.inc │   ├── worker-controller.inc
│   └── worker-normal.inc │   └── worker-normal.inc
└── sogo └── sogo
├── sieve.creds ├── sieve.creds
└── sogo.conf └── sogo.conf
``` ```
Just change the according configuration file on the host and restart the related service: Just change the according configuration file on the host and restart the related service:
``` ```
docker-compose restart service-mailcow docker-compose restart service-mailcow
``` ```
## Tagging ## Tagging
Mailbox users can tag their mail address like in `me+facebook@example.org` and choose between to setups to handle this tag: Mailbox users can tag their mail address like in `me+facebook@example.org` and choose between to setups to handle this tag:
1\. Move this message to a subfolder "facebook" (will be created lower case if not existing) 1\. Move this message to a subfolder "facebook" (will be created lower case if not existing)
2\. Prepend the tag to the subject: "[facebook] Subject" 2\. Prepend the tag to the subject: "[facebook] Subject"
## Two-factor authentication ## Two-factor authentication
@ -398,9 +401,10 @@ The API ID, API key and the first 12 characters (your YubiKeys ID in modhex) are
Only Google Chrome (+derivates) and Opera support U2F authentication to this day natively. Only Google Chrome (+derivates) and Opera support U2F authentication to this day natively.
For Firefox you will need to install the "U2F Support Add-on" as provided on [mozilla.org](https://addons.mozilla.org/en-US/firefox/addon/u2f-support-add-on/). For Firefox you will need to install the "U2F Support Add-on" as provided on [mozilla.org](https://addons.mozilla.org/en-US/firefox/addon/u2f-support-add-on/).
U2F works without an internet connection. U2F works without an internet connection.
## Why Bind? ## Why Bind?
For DNS blacklist lookups and DNSSEC. For DNS blacklist lookups and DNSSEC.