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

80 lines
3.1 KiB
Markdown
Raw Normal View History

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.
### 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
2016-02-10 08:39:41 +00:00
### How can I use data volume container as proposed above?
Here is a `docker-compose.yml` example which use a data volume container for email storage named `maildata`.
maildata:
image: ubuntu
volumes:
- /var/mail
command: /bin/true
mail:
image: "tvial/docker-mailserver"
hostname: "mail"
domainname: "domain.com"
volumes_from:
- maildata
ports:
- "25:25"
- "143:143"
- "587:587"
- "993:993"
volumes:
- ./spamassassin:/tmp/spamassassin/
- ./postfix:/tmp/postfix/
- ./opendkim/keys:/etc/opendkim/keys
- ./letsencrypt/etc:/etc/letsencrypt
environment:
- DMS_SSL=letsencrypt
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`).
Both login and password are managed in `postfix/accounts.cf` file.
Please have a look to the `README` in order to manage users and aliases.
# 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>
### How can I manage my custom Spamassassin rules?
Antispam rules are managed in `spamassassin/rules.cf`.
### 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.
If we're blind, we won't be able to do anything.