diff --git a/docs/compose/requirements.rst b/docs/compose/requirements.rst index 68e1003d..5e5695b5 100644 --- a/docs/compose/requirements.rst +++ b/docs/compose/requirements.rst @@ -26,11 +26,11 @@ Pick a distribution The mail server runs as a set of Docker containers, so it is almost operating system agnostic. -Because most of our tests run on Debian Jessie and Debian Stretch, we recommend +Because most of our tests run on Debian stable, we recommend one of these for the base system. Mailu should however be able to run on any of the `officially supported distributions`_. -For the purpose of this guide, all examples are based on Debian Stretch. The +For the purpose of this guide, all examples are based on Debian stable. The differences with other system will however hardly be noticeable. .. _`officially supported distributions`: https://docs.docker.com/engine/installation/ @@ -38,7 +38,7 @@ differences with other system will however hardly be noticeable. Install the distribution ------------------------ -First, install Debian Stretch from the *netinstall* CD image. When installing, +First, install Debian stable from the *netinstall* CD image. When installing, make sure that you either: - setup a root *ext4* partition, diff --git a/docs/faq.rst b/docs/faq.rst index 8bca7ab6..06d9ef05 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -895,3 +895,19 @@ If not, you can download the `aspell dictionary`_ you require and place it in `` $config['spellcheck_languages'] = array('en'=>'English', ...); .. _`aspell dictionary`: http://ftp.gnu.org/gnu/aspell/dict/0index.html + + +I see a lot of "mount: Deactivated successfully." messages in the logs +`````````````````````````````````````````````````````````````````````` + +This is a docker & systemd issue: see `this workaround`_ + +.. _`this workaround`: https://stackoverflow.com/questions/63622619/docker-flooding-syslog-with-run-docker-runtime-logs/69415949#69415949 + + +I see a lot of "Unable to lookup the TLSA record for XXX. Is the DNSSEC zone okay on ..." messages in the logs +`````````````````````````````````````````````````````````````````````````````````````````````````````````````` + +There may be multiple causes for it but if you are running docker 24.0.0, odds are you are `experiencing this docker bug`_ and the workaround is to switch to a different version of docker. + +.. _`experiencing this docker bug`: https://github.com/Mailu/Mailu/issues/2827 diff --git a/towncrier/newsfragments/2829.misc b/towncrier/newsfragments/2829.misc new file mode 100644 index 00000000..318f6d1b --- /dev/null +++ b/towncrier/newsfragments/2829.misc @@ -0,0 +1,4 @@ +Update the documentation: + - debian Stretch -> debian stable (see #2826) + - docker 24.0.0 is broken (see #2827) + - document how to get rid of "mount: Deactivated successfully" messages from moby (see #2797)