docker-mailserver/docs/content/config/troubleshooting/faq.md

68 lines
2.8 KiB
Markdown
Raw Normal View History

2016-02-01 15:02:34 +01:00
### What kind of database are you using?
None. No *sql database required.
This image is based on config files that can be versioned.
You'll probably want to `push` your config updates to your server and restart the container to apply changes.
2016-10-11 05:25:41 +02:00
### What is the file format?
2016-04-25 06:08:46 +02:00
2016-10-11 05:25:41 +02:00
All files are using the Unix format with `LF` line endings.
Please do not use `CRLF`.
2016-04-25 06:08:46 +02:00
2016-02-01 15:02:34 +01:00
### Where are emails stored?
Mails are stored in `/var/mail/${domain}/${username}`.
2016-02-10 09:42:22 +01:00
You should use a [data volume container](https://medium.com/@ramangupta/why-docker-data-containers-are-good-589b3c6c749e#.uxyrp7xpu) for `/var/mail` to persist data. Otherwise, your data may be lost.
2016-02-10 09:36:57 +01:00
### What about backups?
Assuming that you use `docker-compose` and a data volume container named `maildata`, you can backup your user mails like this:
docker run --rm \
--volumes-from maildata_1 \
-v "$(pwd)":/backups \
-ti tvial/docker-mailserver \
tar cvzf /backups/docker-mailserver-`date +%y%m%d-%H%M%S`.tgz /var/mail
2016-02-01 15:02:34 +01:00
### How can I configure my email client?
Login are full email address (`user@domain.com`).
# imap
username: <user1@domain.tld>
password: <mypassword>
server: <mail.domain.tld>
imap port: 143 or 993 with ssl (recommended)
imap path prefix: INBOX
# smtp
smtp port: 25 or 587 with ssl (recommended)
username: <user1@domain.tld>
password: <mypassword>
2016-04-22 17:01:44 +02:00
Please use `STARTTLS`.
2016-02-01 15:02:34 +01:00
### How can I manage my custom Spamassassin rules?
2016-09-12 16:00:05 +02:00
Antispam rules are managed in `config/spamassassin-rules.cf`.
### How can I make Spamassassin learn spam?
Put received spams in `.Junk/` imap folder and add a cron like the fllowing:
```
# Everyday 2:00AM, learn spam for this specific user
0 2 * * * docker exec mail sa-learn --spam /var/mail/domain.com/username/.Junk
```
2016-02-01 15:02:34 +01:00
### What kind of SSL certificates can I use?
You can use the same certificates you use with another mail server.
2016-03-04 18:56:45 +01:00
The only thing is that we provide a `self-signed` certificate tool and a `letsencrypt` certificate loader.
2016-03-04 18:57:22 +01:00
### I just moved from my old mail server but "it doesn't work".
2016-03-04 18:56:45 +01:00
If this migration implies a DNS modification, be sure to wait for DNS propagation before opening an issue.
Few examples of symptoms can be found [here](https://github.com/tomav/docker-mailserver/issues/95) or [here](https://github.com/tomav/docker-mailserver/issues/97).
2016-03-04 18:59:32 +01:00
This could be related to a modification of your `MX` record, or the IP mapped to `mail.my-domain.tld`.
If everything is OK regarding DNS, please provide [formatted logs](https://guides.github.com/features/mastering-markdown/) and config files. This will allow us to help you.
2016-09-20 16:34:48 +02:00
If we're blind, we won't be able to do anything.
### Which system requirements needs my container to run `docker-mailserver` effectively?
1 core and 1GB of RAM is recommended, even it could work with 512M of RAM.