diff --git a/README.md b/README.md index 7d8e1a05..cef7d02e 100644 --- a/README.md +++ b/README.md @@ -82,7 +82,7 @@ wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/maste wget https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/master/mailserver.env ``` -and the `setup.sh` +and the `setup.sh` **in the correct version** ``` BASH # if you're using :edge as the image tag @@ -96,7 +96,7 @@ chmod a+x ./setup.sh ./setup.sh help ``` -**Make sure to get the `setup.sh` that comes with the release you're using**. Look up the release and the git commit on which this release is based upon by selecting the appropriate tag on GitHub. This is done to rule out possible inconsistencies between versions. +**Make sure to get the `setup.sh` that comes with the release you're using**. Look up the release and the git commit on which this release is based upon by selecting the appropriate tag on GitHub. This can done with the "Switch branches/tags" button on GitHub, choosing the right tag. This is done in order to rule out possible inconsistencies between versions. ### Create a docker-compose environment @@ -128,7 +128,9 @@ docker-compose up -d mail ./setup.sh -Z config dkim ``` -If you are using a LDAP setup the setup looks a bit different as you do not add user accounts directly. Postfix doesn't know your domain(s) and you need to provide it when configuring DKIM: +If you're seeing error messages about unchecked error, please **verify that you're using the right version of `setup.sh`**. Refer to the [Get the tools](#get-the-tools) section. + +If you are using a LDAP, the setup looks a bit different as you do not add user accounts directly. Postfix doesn't know your domain(s) and you need to provide it when configuring DKIM: ``` BASH ./setup.sh config dkim domain '[,]' diff --git a/setup.sh b/setup.sh index e37c4a96..e145b42b 100755 --- a/setup.sh +++ b/setup.sh @@ -17,6 +17,10 @@ function __log_err " – function = ${1} / ${2}" \ " – line = ${3}" \ " – exit code = ${4}" >&2 + + printf "Make sure you use a version of this script that matches +the version / tag of docker-mailserver. Please read the +'Get the tools' section in the README on GitHub carefully.\n" >&2 } function _unset_vars @@ -122,6 +126,15 @@ function _usage its arguments by appending \e[37mhelp\e[39m after your command. Currently, this does not work with all scripts. +\e[38;5;214mVERSION\e[39m + The current version of this script is backwards compatible with versions of + \e[37mdocker-mailserver\e[39m \e[1mafter\e[0m \e[34m8.0.1\e[0m. In case that there is not a more recent release, + this script is currently only working with the \e[37m:edge\e[0m tag. + + You can download the script for your release by substituting TAG from the + following URL, where TAG looks like 'vX.X.X': + https://raw.githubusercontent.com/docker-mailserver/docker-mailserver/TAG/setup.sh + \e[38;5;214mOPTIONS\e[39m \e[94mConfig path, container or image adjustments\e[39m -i IMAGE_NAME