2016-02-01 14:02:34 +00: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-12-17 15:29:44 +00:00
### How can I sync container with host date/time?
Share the host `/etc/localtime` using:
```
volumes:
- /etc/localtime:/etc/localtime:ro
```
2016-10-11 03:25:41 +00:00
### What is the file format?
2016-04-25 04:08:46 +00:00
2016-10-11 03:25:41 +00:00
All files are using the Unix format with `LF` line endings.
Please do not use `CRLF` .
2016-04-25 04:08:46 +00:00
2016-02-01 14:02:34 +00:00
### Where are emails stored?
Mails are stored in `/var/mail/${domain}/${username}` .
2016-02-10 08:42:22 +00: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 08:36:57 +00: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 14:02:34 +00: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 15:01:44 +00:00
Please use `STARTTLS` .
2016-02-01 14:02:34 +00:00
### How can I manage my custom Spamassassin rules?
2016-09-12 14:00:05 +00: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
2017-01-05 08:06:21 +00:00
0 2 * * * docker exec mail sa-learn --spam /var/mail/domain.com/username/.Junk --dbpath /var/mail-state/lib-amavis/.spamassassin
2016-09-12 14:00:05 +00:00
```
2016-02-01 14:02:34 +00:00
### What kind of SSL certificates can I use?
You can use the same certificates you use with another mail server.
2016-03-04 17:56:45 +00:00
The only thing is that we provide a `self-signed` certificate tool and a `letsencrypt` certificate loader.
2016-03-04 17:57:22 +00:00
### I just moved from my old mail server but "it doesn't work".
2016-03-04 17:56:45 +00: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 17:59:32 +00: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 14:34:48 +00:00
If we're blind, we won't be able to do anything.
### Which system requirements needs my container to run `docker-mailserver` effectively?
2016-10-27 15:01:08 +00:00
1 core and 1GB of RAM is recommended, even it could work with 512M of RAM.
### Is `docker-mailserver` running in a [rancher environment](http://rancher.com/rancher/)?
2016-12-15 21:45:19 +00:00
Yes, by Adding the Environment Variable `PERMIT_DOCKER: network` .