github-com-docker-mailserver/docker-mailserver
1
0
Fork 0
mirror of https://github.com/docker-mailserver/docker-mailserver.git synced 2024-01-19 02:48:50 +00:00
Code Issues Projects Releases Wiki Activity

adjusting links & misc

Browse source
This commit is contained in:
Georg Lauterbach 2021-01-19 09:27:01 +01:00
parent dba291dc43
commit 221d4ce187
No known key found for this signature in database
GPG key ID: 2FDC58699AF121C6
10 changed files with 30 additions and 27 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
.github/ISSUE_TEMPLATE/bug_report.md vendored
View file

@ -2,7 +2,7 @@
name: "\U0001F41E Bug report" name: "\U0001F41E Bug report"
about: Create a report about a reproducible bug about: Create a report about a reproducible bug
title: "[BUG]" title: "[BUG]"
labels: area/bug, meta/needs triage, priority/medium labels: kind/bug, meta/needs triage, priority/medium
assignees: "" assignees: ""
--- ---
@ -13,21 +13,21 @@ Possible answers to your issue
https://github.com/docker-mailserver/docker-mailserver#requirements https://github.com/docker-mailserver/docker-mailserver#requirements
* Email seen as spam: * Email seen as spam:
https://github.com/tomav/docker-mailserver/wiki/Configure-SPF https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-SPF
https://github.com/tomav/docker-mailserver/wiki/Configure-DKIM https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-DKIM
* Creating new domains and accounts * Creating new domains and accounts
https://github.com/tomav/docker-mailserver/wiki/Configure-Accounts https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-Accounts
* Use a relay mail server * Use a relay mail server
https://github.com/tomav/docker-mailserver/wiki/Configure-AWS-SES https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-AWS-SES
The variable name can be used for other email servers. The variable name can be used for other email servers.
* FAQ and tips * FAQ and tips
https://github.com/tomav/docker-mailserver/wiki/FAQ-and-Tips https://github.com/docker-mailserver/docker-mailserver/wiki/FAQ-and-Tips
* The wiki * The wiki
https://github.com/tomav/docker-mailserver/wiki https://github.com/docker-mailserver/docker-mailserver/wiki
* Open issues * Open issues
https://github.com/docker-mailserver/docker-mailserver/issues https://github.com/docker-mailserver/docker-mailserver/issues

2
.github/ISSUE_TEMPLATE/feature_request.md vendored
View file

@ -2,7 +2,7 @@
name: "\U0001F389 Feature request" name: "\U0001F389 Feature request"
about: Suggest an idea for this project about: Suggest an idea for this project
title: '[FR]' title: '[FR]'
labels: area/enhancement, kind/feature request, meta/needs triage, priority/low labels: area/enhancement, kind/feature (request), meta/needs triage, priority/low
assignees: '' assignees: ''
--- ---

6
.github/workflows/close_stale_issues.yml vendored
View file

@ -12,10 +12,10 @@ jobs:
uses: actions/stale@v3 uses: actions/stale@v3
with: with:
repo-token: ${{ secrets.GITHUB_TOKEN }} repo-token: ${{ secrets.GITHUB_TOKEN }}
days-before-stale: 1 # TODO just for testing purposes, otherwise (20) days-before-stale: 20
days-before-close: 1 # TODO just for testing purposes, otherwise (10) days-before-close: 10
stale-issue-label: "meta/stale" stale-issue-label: "meta/stale"
close-issue-label: "meta/frozen due to age or inactivity" close-issue-label: "meta/closed due to age or inactivity"
stale-issue-message: > stale-issue-message: >
This issue has become stale because it has been open for 20 days without This issue has become stale because it has been open for 20 days without
activity. Remove the label and comment or this issue will be closed in 10 days. activity. Remove the label and comment or this issue will be closed in 10 days.

6
ENVIRONMENT.md
View file

@ -58,14 +58,14 @@ Otherwise, `iptables` won't be able to ban IPs.
- self-signed => Enables self-signed certificates - self-signed => Enables self-signed certificates
- _any other value_ => SSL required, settings by default - _any other value_ => SSL required, settings by default
Please read [the SSL page in the wiki](https://github.com/tomav/docker-mailserver/wiki/Configure-SSL) for more information. Please read [the SSL page in the wiki](https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-SSL) for more information.
##### TLS_LEVEL ##### TLS_LEVEL
- **empty** => modern - **empty** => modern
- modern => Enables TLSv1.2 and modern ciphers only. (default) - modern => Enables TLSv1.2 and modern ciphers only. (default)
- intermediate => Enables TLSv1, TLSv1.1 and TLSv1.2 and broad compatibility ciphers. - intermediate => Enables TLSv1, TLSv1.1 and TLSv1.2 and broad compatibility ciphers.
- old => NOT implemented. If you really need it, then customize the TLS ciphers overriding postfix and dovecot settings [wiki](https://github.com/tomav/docker-mailserver/wiki/) - old => NOT implemented. If you really need it, then customize the TLS ciphers overriding postfix and dovecot settings [wiki](https://github.com/docker-mailserver/docker-mailserver/wiki/)
##### SPOOF_PROTECTION ##### SPOOF_PROTECTION
@ -132,7 +132,7 @@ Set the mailbox size limit for all users. If set to zero, the size will be unlim
- **1** => Dovecot quota is enabled - **1** => Dovecot quota is enabled
- 0 => Dovecot quota is disabled - 0 => Dovecot quota is disabled
See [mailbox quota](https://github.com/tomav/docker-mailserver/wiki/Configure-Accounts#mailbox-quota). See [mailbox quota](https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-Accounts#mailbox-quota).
##### POSTFIX\_MESSAGE\_SIZE\_LIMIT ##### POSTFIX\_MESSAGE\_SIZE\_LIMIT

14
README.md
View file

@ -22,7 +22,7 @@ A fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.)
## Included Services ## Included Services
- [Postfix](http://www.postfix.org) with SMTP or LDAP auth - [Postfix](http://www.postfix.org) with SMTP or LDAP auth
- [Dovecot](https://www.dovecot.org) for SASL, IMAP (or POP3), with LDAP Auth, Sieve and [quotas](https://github.com/tomav/docker-mailserver/wiki/Configure-Accounts#mailbox-quota) - [Dovecot](https://www.dovecot.org) for SASL, IMAP (or POP3), with LDAP Auth, Sieve and [quotas](https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-Accounts#mailbox-quota)
- [Amavis](https://www.amavis.org/) - [Amavis](https://www.amavis.org/)
- [Spamassasin](http://spamassassin.apache.org/) supporting custom rules - [Spamassasin](http://spamassassin.apache.org/) supporting custom rules
- [ClamAV](https://www.clamav.net/) with automatic updates - [ClamAV](https://www.clamav.net/) with automatic updates
@ -33,8 +33,8 @@ A fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.)
- [Postscreen](http://www.postfix.org/POSTSCREEN_README.html) - [Postscreen](http://www.postfix.org/POSTSCREEN_README.html)
- [Postgrey](https://postgrey.schweikert.ch/) - [Postgrey](https://postgrey.schweikert.ch/)
- [LetsEncrypt](https://letsencrypt.org/) and self-signed certificates - [LetsEncrypt](https://letsencrypt.org/) and self-signed certificates
- [Setup script](https://github.com/tomav/docker-mailserver/wiki/Setup-docker-mailserver-using-the-script-setup.sh) to easily configure and maintain your mailserver - [Setup script](https://github.com/docker-mailserver/docker-mailserver/wiki/Setup-docker-mailserver-using-the-script-setup.sh) to easily configure and maintain your mailserver
- Basic [Sieve support](https://github.com/tomav/docker-mailserver/wiki/Configure-Sieve-filters) using dovecot - Basic [Sieve support](https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-Sieve-filters) using dovecot
- SASLauthd with LDAP auth - SASLauthd with LDAP auth
- Persistent data and state - Persistent data and state
- [CI/CD](https://github.com/docker-mailserver/docker-mailserver/actions) - [CI/CD](https://github.com/docker-mailserver/docker-mailserver/actions)
@ -42,7 +42,7 @@ A fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.)
## Opening Issues and Contributing ## Opening Issues and Contributing
**Before opening an issue**, read this `README` carefully, use the [Wiki](https://github.com/tomav/docker-mailserver/wiki/), the Postfix/Dovecot documentation and your search engine you trust. The issue tracker is not meant to be used for unrelated questions! If you'd like to contribute, read [`CONTRIBUTING.md`](./CONTRIBUTING.md) thoroughly. **Before opening an issue**, read this `README` carefully, use the [Wiki](https://github.com/docker-mailserver/docker-mailserver/wiki/), the Postfix/Dovecot documentation and your search engine you trust. The issue tracker is not meant to be used for unrelated questions! If you'd like to contribute, read [`CONTRIBUTING.md`](./CONTRIBUTING.md) thoroughly.
## Requirements ## Requirements
@ -57,7 +57,7 @@ A fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.)
- 1 vCore - 1 vCore
- 512MB RAM - 512MB RAM
**Note:** You'll need to deactivate some services like ClamAV to be able to run on a host with 512MB of RAM. Even with 1G RAM you may run into problems without swap, see [FAQ](https://github.com/tomav/docker-mailserver/wiki/FAQ-and-Tips). **Note:** You'll need to deactivate some services like ClamAV to be able to run on a host with 512MB of RAM. Even with 1G RAM you may run into problems without swap, see [FAQ](https://github.com/docker-mailserver/docker-mailserver/wiki/FAQ-and-Tips).
## Usage ## Usage
@ -84,7 +84,7 @@ chmod a+x ./setup.sh
- don't quote your values - don't quote your values
- variable substitution is *not* supported (e.g. `OVERRIDE_HOSTNAME=$HOSTNAME.$DOMAINNAME`). - variable substitution is *not* supported (e.g. `OVERRIDE_HOSTNAME=$HOSTNAME.$DOMAINNAME`).
- Variables in `.env` are expanded in the `docker-compose.yml` file **only** and **not** in the container. The file `mailserver.env` serves this case where environment variables are used in the container. - Variables in `.env` are expanded in the `docker-compose.yml` file **only** and **not** in the container. The file `mailserver.env` serves this case where environment variables are used in the container.
- If you want to use a bare domain (host name = domain name), see [FAQ](https://github.com/tomav/docker-mailserver/wiki/FAQ-and-Tips#can-i-use-nakedbare-domains-no-host-name) - If you want to use a bare domain (host name = domain name), see [FAQ](https://github.com/docker-mailserver/docker-mailserver/wiki/FAQ-and-Tips#can-i-use-nakedbare-domains-no-host-name)
### Get up and running ### Get up and running
@ -189,7 +189,7 @@ If you got any problems with SPF and/or forwarding mails, give [SRS](https://git
2. Receives email and filters for spam and viruses. For submitting outgoing mail you should prefer the submission ports(465, 587), which require authentication. Unless a relay host is configured, outgoing email will leave the server via port 25(thus outbound traffic must not be blocked by your provider or firewall). 2. Receives email and filters for spam and viruses. For submitting outgoing mail you should prefer the submission ports(465, 587), which require authentication. Unless a relay host is configured, outgoing email will leave the server via port 25(thus outbound traffic must not be blocked by your provider or firewall).
3. A submission port since 2018, [RFC 8314](https://tools.ietf.org/html/rfc8314). Originally a secure variant of port 25. 3. A submission port since 2018, [RFC 8314](https://tools.ietf.org/html/rfc8314). Originally a secure variant of port 25.
See the [wiki](https://github.com/tomav/docker-mailserver/wiki) for further details and best practice advice, especially regarding security concerns. See the [wiki](https://github.com/docker-mailserver/docker-mailserver/wiki) for further details and best practice advice, especially regarding security concerns.
## Examples ## Examples

6
mailserver.env
View file

@ -21,7 +21,7 @@ POSTMASTER_ADDRESS=
# Set different options for mynetworks option (can be overwrite in postfix-main.cf) # Set different options for mynetworks option (can be overwrite in postfix-main.cf)
# **WARNING**: Adding the docker network's gateway to the list of trusted hosts, e.g. using the `network` or # **WARNING**: Adding the docker network's gateway to the list of trusted hosts, e.g. using the `network` or
# `connected-networks` option, can create an open relay # `connected-networks` option, can create an open relay
# https://github.com/tomav/docker-mailserver/issues/1405#issuecomment-590106498 # https://github.com/docker-mailserver/docker-mailserver/issues/1405#issuecomment-590106498
# empty => localhost only # empty => localhost only
# host => Add docker host (ipv4 only) # host => Add docker host (ipv4 only)
# network => Add all docker containers (ipv4 only) # network => Add all docker containers (ipv4 only)
@ -37,7 +37,7 @@ NETWORK_INTERFACE=
# modern => Enables TLSv1.2 and modern ciphers only. (default) # modern => Enables TLSv1.2 and modern ciphers only. (default)
# intermediate => Enables TLSv1, TLSv1.1 and TLSv1.2 and broad compatibility ciphers. # intermediate => Enables TLSv1, TLSv1.1 and TLSv1.2 and broad compatibility ciphers.
# old => NOT implemented. If you really need it, then customize the TLS ciphers overriding postfix and dovecot settings # old => NOT implemented. If you really need it, then customize the TLS ciphers overriding postfix and dovecot settings
# (https://github.com/tomav/docker-mailserver/wiki/) # (https://github.com/docker-mailserver/docker-mailserver/wiki/)
TLS_LEVEL= TLS_LEVEL=
# Configures the handling of creating mails with forged sender addresses. # Configures the handling of creating mails with forged sender addresses.
@ -78,7 +78,7 @@ POSTSCREEN_ACTION=enforce
# 1 => only launch postfix smtp # 1 => only launch postfix smtp
SMTP_ONLY= SMTP_ONLY=
# Please read [the SSL page in the wiki](https://github.com/tomav/docker-mailserver/wiki/Configure-SSL) for more information. # Please read [the SSL page in the wiki](https://github.com/docker-mailserver/docker-mailserver/wiki/Configure-SSL) for more information.
# #
# empty => SSL disabled # empty => SSL disabled
# letsencrypt => Enables Let's Encrypt certificates # letsencrypt => Enables Let's Encrypt certificates

3
target/scripts/start-mailserver.sh
View file

@ -806,6 +806,9 @@ function _setup_ldap
_notify 'inf' "==> Warning: /etc/postfix/ldap-aliases.cf or /etc/postfix/ldap-groups.cf not found" _notify 'inf' "==> Warning: /etc/postfix/ldap-aliases.cf or /etc/postfix/ldap-groups.cf not found"
fi fi
# shellcheck disable=SC2016
sed -i -E 's+mydestination = $myhostname, +mydestination = +' /etc/postfix/main.cf
return 0 return 0
} }

2
test/mail_dhparams_default.bats
View file

@ -2,7 +2,7 @@ load 'test_helper/common'
# Test case # Test case
# --------- # ---------
# By default, this image is using audited FFDHE groups (https://github.com/tomav/docker-mailserver/pull/1463) # By default, this image is using audited FFDHE groups (https://github.com/docker-mailserver/docker-mailserver/pull/1463)
# #
# This test case covers the described case against both boolean states for `ONE_DIR`. # This test case covers the described case against both boolean states for `ONE_DIR`.
# #

2
test/mail_dhparams_manual_not_one_dir.bats
View file

@ -2,7 +2,7 @@ load 'test_helper/common'
# Test case # Test case
# --------- # ---------
# By default, this image is using audited FFDHE groups (https://github.com/tomav/docker-mailserver/pull/1463) # By default, this image is using audited FFDHE groups (https://github.com/docker-mailserver/docker-mailserver/pull/1463)
# #
# This test case covers the described case when `ONE_DIR=0`. # This test case covers the described case when `ONE_DIR=0`.
# #

2
test/mail_dhparams_manual_one_dir.bats
View file

@ -2,7 +2,7 @@ load 'test_helper/common'
# Test case # Test case
# --------- # ---------
# By default, this image is using audited FFDHE groups (https://github.com/tomav/docker-mailserver/pull/1463) # By default, this image is using audited FFDHE groups (https://github.com/docker-mailserver/docker-mailserver/pull/1463)
# #
# This test case covers the described case when `ONE_DIR=1`. # This test case covers the described case when `ONE_DIR=1`.
# #