deploy: 2bc3e821fa

edge/config/environment/index.html

@@ -3076,8 +3076,8 @@
 <p>The log-level will show everything in its class and above.</p>
 <h5 id="one_dir"><a class="toclink" href="#one_dir">ONE_DIR</a></h5>
 <ul>
-<li><strong>0</strong> =&gt; state in default directories.</li>
-<li>1 =&gt; consolidate all states into a single directory (<code>/var/mail-state</code>) to allow persistence using docker volumes.</li>
+<li>0 =&gt; state in default directories.</li>
+<li><strong>1</strong> =&gt; consolidate all states into a single directory (<code>/var/mail-state</code>) to allow persistence using docker volumes. See the <a href="../../faq/#what-is-the-mail-state-folder-for">related FAQ entry</a> for more information.</li>
 </ul>
 <h5 id="permit_docker"><a class="toclink" href="#permit_docker">PERMIT_DOCKER</a></h5>
 <p>Set different options for mynetworks option (can be overwrite in postfix-main.cf) <strong>WARNING</strong>: Adding the docker network's gateway to the list of trusted hosts, e.g. using the <code>network</code> or <code>connected-networks</code> option, can create an <a href="https://en.wikipedia.org/wiki/Open_mail_relay"><strong>open relay</strong></a>, for instance if IPv6 is enabled on the host machine but not in Docker.</p>

edge/faq/index.html

@@ -1196,8 +1196,8 @@
 </li>
       
         <li class="md-nav__item">
-  <a href="#what-about-mail-state-folder" class="md-nav__link">
-    What about mail-state folder?
+  <a href="#what-is-the-mail-state-folder-for" class="md-nav__link">
+    What is the mail-state folder for?
   </a>
   
 </li>
@@ -1543,8 +1543,8 @@
 </li>
       
         <li class="md-nav__item">
-  <a href="#what-about-mail-state-folder" class="md-nav__link">
-    What about mail-state folder?
+  <a href="#what-is-the-mail-state-folder-for" class="md-nav__link">
+    What is the mail-state folder for?
   </a>
   
 </li>
@@ -1761,9 +1761,10 @@ docker run --rm -it <span class="se">\</span>
 <span class="c1"># delete backups older than 30 days</span>
 find /backup/mail -type f -mtime +30 -delete
 </code></pre></div>
-<h3 id="what-about-mail-state-folder"><a class="toclink" href="#what-about-mail-state-folder">What about <code>mail-state</code> folder?</a></h3>
-<p>This folder consolidates all data generated by the server itself to persist when you upgrade.
-Example of data folder persisted: lib-amavis, lib-clamav, lib-fail2ban, lib-postfix, lib-postgrey, lib-spamassasin, lib-spamassassin, spool-postfix, ...</p>
+<h3 id="what-is-the-mail-state-folder-for"><a class="toclink" href="#what-is-the-mail-state-folder-for">What is the <code>mail-state</code> folder for?</a></h3>
+<p>When you run <code>docker-mailserver</code> with the ENV var <code>ONE_DIR=1</code> (<em>default since v10.2</em>), this folder will store the data from internal services so that you can more easily persist state to disk (via <code>volumes</code>).</p>
+<p>This has the advantage of fail2ban blocks, ClamAV anti-virus updates and the like being kept across restarts for example.</p>
+<p>Service data is <a href="https://github.com/docker-mailserver/docker-mailserver/blob/c7e498194546416fb7231cb03254e77e085d18df/target/scripts/startup/misc-stack.sh#L24-L33">relocated to the <code>mail-state</code> folder</a> for services: Postfix, Dovecot, Fail2Ban, Amavis, PostGrey, ClamAV, SpamAssassin.</p>
 <h3 id="how-can-i-configure-my-email-client"><a class="toclink" href="#how-can-i-configure-my-email-client">How can I configure my email client?</a></h3>
 <p>Login are full email address (<code>user@domain.com</code>).</p>
 <div class="highlight"><pre><span></span><code><span class="c"># imap</span>