From ea7348ef46837ecc9ec1718c917ed322f954f5e9 Mon Sep 17 00:00:00 2001 From: timo Date: Sat, 6 May 2017 21:59:23 +0200 Subject: [PATCH] Added chapter on 'Common Problems' --- docs/images/mailcow-backupmx.png | Bin 0 -> 6740 bytes docs/troubles.md | 54 +++++++++++++++++++++++++++++++ mkdocs.yml | 1 + 3 files changed, 55 insertions(+) create mode 100644 docs/images/mailcow-backupmx.png create mode 100644 docs/troubles.md diff --git a/docs/images/mailcow-backupmx.png b/docs/images/mailcow-backupmx.png new file mode 100644 index 0000000000000000000000000000000000000000..889b2f7a1212b02bc3aa8954db4dedda8d9a6144 GIT binary patch literal 6740 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 literal 0 HcmV?d00001 diff --git a/docs/troubles.md b/docs/troubles.md new file mode 100644 index 000000000..d39ee7579 --- /dev/null +++ b/docs/troubles.md @@ -0,0 +1,54 @@ +Here we list common problems and possible solutions: + +## Mail loops back to myself + +Please check in your mailcow UI if you made the domain a **backup MX**: + +![Check your MX Backup settings](images/mailcow-backupmx.png) + +## I can receive but not send mails + +There are a lot of things that could prevent you from sending mail: + +- Check if your IP is on any blacklists. You could use [dnsbl.info](http://www.dnsbl.info/) or any other similar service to check for your IP. +- There are some consumer ISP routers out there, that block mailports for non whitelisted domains. Please check if you can reach your server on the ports `465` or `587`: + +``` +# telnet 74.125.133.27 465 +Trying 74.125.133.27... +Connected to 74.125.133.27. +Escape character is '^]'. +``` + +## My mails are identified as Spam + +Please read our guide on [DNS configuration](dns.md). + +## docker-compose throws weird erros + +... like: + +- `ERROR: Invalid interpolation format ...` +- `AttributeError: 'NoneType' object has no attribute 'keys'`. +- `ERROR: In file './docker-compose.yml' service 'version' doesn't have any configuration options`. + +When you encounter one or similar messages while trying to run mailcow: dockerized please check if you have the **latest** version of **Docker** and **docker-compose** + +## Container XY is unhealthy + +This error tries to tell you that one of the (health) conditions for a certain container are not met. Therefore it can't be started. This can have several reasons, the most common one is an updated git clone but old docker image or vice versa. + +A wrong configured firewall could also cause such a failure. The containers need to be able to talk to each other over the network 172.22.1.1/24. + +It might also be wrongly linked file (i.e. SSL certificate) that prevents a crucial container (nginx) from starting, so always check your logs to get an Idea where your problem is coming from. + + +## Address already in use + +If you get an error message like: + +``` +ERROR: for postfix-mailcow Cannot start service postfix-mailcow: driver failed programming external connectivity on endpoint mailcowdockerized_postfix-mailcow_1: Error starting userland proxy: listen tcp 0.0.0.0:25: bind: address already in use +``` + +while trying to start / install mailcow: dockerized, make sure you've followed our section on the [prerequisites](requirements/#firewall-ports). diff --git a/mkdocs.yml b/mkdocs.yml index 4632fb050..186fbe284 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -34,6 +34,7 @@ pages: - 'Attach a Container': 'attach_service.md' - 'Reset Passwords': 'reset_pw.md' - 'Remove Persistent Data': 'rm_volumes.md' + - 'Common Problems': 'troubles.md' - 'Usage & Examples': - 'mailcow UI': - 'Configuration': 'mailcow_ui.md'