This commit is contained in:
github-actions[bot] 2022-09-28 07:25:39 +00:00
parent 6f5a7d472b
commit a2a342278e
3 changed files with 152 additions and 45 deletions

View file

@ -1221,6 +1221,53 @@
Building your own Docker image
</a>
<nav class="md-nav" aria-label="Building your own Docker image">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#submodules" class="md-nav__link">
Submodules
</a>
</li>
<li class="md-nav__item">
<a href="#about-docker" class="md-nav__link">
About Docker
</a>
<nav class="md-nav" aria-label="About Docker">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#version" class="md-nav__link">
Version
</a>
</li>
<li class="md-nav__item">
<a href="#environment" class="md-nav__link">
Environment
</a>
</li>
<li class="md-nav__item">
<a href="#build-arguments" class="md-nav__link">
Build Arguments
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
</ul>
@ -1456,6 +1503,53 @@
Building your own Docker image
</a>
<nav class="md-nav" aria-label="Building your own Docker image">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#submodules" class="md-nav__link">
Submodules
</a>
</li>
<li class="md-nav__item">
<a href="#about-docker" class="md-nav__link">
About Docker
</a>
<nav class="md-nav" aria-label="About Docker">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#version" class="md-nav__link">
Version
</a>
</li>
<li class="md-nav__item">
<a href="#environment" class="md-nav__link">
Environment
</a>
</li>
<li class="md-nav__item">
<a href="#build-arguments" class="md-nav__link">
Build Arguments
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
</ul>
@ -1479,16 +1573,29 @@
<h1>Building your own Docker image</h1>
<h2 id="building-your-own-docker-image"><a class="toclink" href="#building-your-own-docker-image">Building your own Docker image</a></h2>
<h3 id="submodules"><a class="toclink" href="#submodules">Submodules</a></h3>
<p>You'll need to retrieve the git submodules prior to building your own Docker image. From within your copy of the git repo run the following to retrieve the submodules and build the Docker image:</p>
<div class="highlight"><pre><span></span><code>git submodule update --init --recursive
docker build -t mailserver/docker-mailserver .
</code></pre></div>
<p>Or, you can clone and retrieve the submodules in one command:
<p>Or, you can clone and retrieve the submodules in one command:</p>
<div class="highlight"><pre><span></span><code>git clone --recurse-submodules https://github.com/docker-mailserver/docker-mailserver
</code></pre></div></p>
<p>Retrieving the git submodules will fix the error:
</code></pre></div>
<p>Retrieving the git submodules will fix the error:</p>
<div class="highlight"><pre><span></span><code>COPY failed: file not found in build context or excluded by .dockerignore: stat target/docker-configomat/configomat.sh: file does not exist
</code></pre></div></p>
</code></pre></div>
<h3 id="about-docker"><a class="toclink" href="#about-docker">About Docker</a></h3>
<h4 id="version"><a class="toclink" href="#version">Version</a></h4>
<p>We make use of build-features that require a recent version of Docker. Depending on your distribution, please have a look at <a href="https://docs.docker.com/engine/install/">the official installation documentation for Docker</a> to get the latest version. Otherwise, you may encounter issues, for example with the <code>--link</code> flag for a <a href="https://docs.docker.com/engine/reference/builder/#copy"><code class="highlight"><span class="k">COPY</span><span class="w"></span></code></a> command.</p>
<h4 id="environment"><a class="toclink" href="#environment">Environment</a></h4>
<p>If you are not using <code>make</code> to build the image, note that you will need to provide <code>DOCKER_BUILDKIT=1</code> to the <code>docker build</code> command for the build to succeed.</p>
<h4 id="build-arguments"><a class="toclink" href="#build-arguments">Build Arguments</a></h4>
<p>The <code>Dockerfile</code> takes additional, so-called build arguments. These are</p>
<ol>
<li><code>VCS_VERSION</code>: the image version (default = edge)</li>
<li><code>VCS_REVISION</code>: the image revision (default = unknown)</li>
</ol>
<p>When using <code>make</code> to build the image, these are filled with proper values. You can build the image without supplying these arguments just fine though.</p>
</article>

File diff suppressed because one or more lines are too long

View file

@ -2,202 +2,202 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/faq/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/introduction/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/environment/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/pop3/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/setup.sh/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/auth-ldap/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/dovecot-master-accounts/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/full-text-search/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/ipv6/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/kubernetes/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/mail-fetchmail/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/mail-sieve/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/optional-config/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/podman/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/mail-forwarding/aws-ses/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/mail-forwarding/relay-hosts/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/maintenance/update-and-cleanup/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/override-defaults/dovecot/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/override-defaults/postfix/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/advanced/override-defaults/user-patches/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/best-practices/autodiscover/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/best-practices/dkim/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/best-practices/dmarc/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/best-practices/spf/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/security/fail2ban/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/security/mail_crypt/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/security/ssl/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/security/understanding-the-ports/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/troubleshooting/debugging/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/user-management/accounts/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/config/user-management/aliases/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/contributing/general/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/contributing/issues-and-pull-requests/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/examples/tutorials/basic-installation/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/examples/tutorials/blog-posts/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/examples/tutorials/docker-build/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/examples/tutorials/mailserver-behind-proxy/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/examples/use-cases/forward-only-mailserver-with-ldap-authentication/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://docker-mailserver.github.io/docker-mailserver/edge/examples/use-cases/imap-folders/</loc>
<lastmod>2022-09-23</lastmod>
<lastmod>2022-09-28</lastmod>
<changefreq>daily</changefreq>
</url>
</urlset>