You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-dev@james.apache.org by ie...@apache.org on 2020/07/07 12:57:53 UTC
[james-site] branch asf-staging updated: [JAMES-3226] #comment
Manual publish to staging
This is an automated email from the ASF dual-hosted git repository.
ieugen pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/james-site.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new 55a8b64 [JAMES-3226] #comment Manual publish to staging
55a8b64 is described below
commit 55a8b64e57615b7814a33d65467a4fa24ca93424
Author: Eugen Stan <eu...@ieugen.ro>
AuthorDate: Tue Jul 7 15:57:28 2020 +0300
[JAMES-3226] #comment Manual publish to staging
---
.asf.yaml | 9 +
404.html | 107 ++++++
_/css/site.css | 3 +
_/font/roboto-latin-400.woff | Bin 0 -> 20268 bytes
_/font/roboto-latin-400.woff2 | Bin 0 -> 15736 bytes
_/font/roboto-latin-400italic.woff | Bin 0 -> 21952 bytes
_/font/roboto-latin-400italic.woff2 | Bin 0 -> 17324 bytes
_/font/roboto-latin-500.woff | Bin 0 -> 20464 bytes
_/font/roboto-latin-500.woff2 | Bin 0 -> 15872 bytes
_/font/roboto-latin-500italic.woff | Bin 0 -> 22020 bytes
_/font/roboto-latin-500italic.woff2 | Bin 0 -> 17316 bytes
_/font/roboto-mono-latin-400.woff | Bin 0 -> 19972 bytes
_/font/roboto-mono-latin-400.woff2 | Bin 0 -> 16328 bytes
_/font/roboto-mono-latin-500.woff | Bin 0 -> 20040 bytes
_/font/roboto-mono-latin-500.woff2 | Bin 0 -> 16380 bytes
_/img/back.svg | 1 +
_/img/caret.svg | 1 +
_/img/chevron.svg | 1 +
_/img/close.svg | 1 +
_/img/home-o.svg | 1 +
_/img/home.svg | 1 +
_/img/menu.svg | 1 +
_/js/site.js | 5 +
_/js/vendor/highlight.js | 1 +
index.html | 9 +
main/3.5/community/index.html | 228 ++++++++++++
main/3.5/concepts/glossary.html | 301 ++++++++++++++++
main/3.5/concepts/index.html | 304 ++++++++++++++++
main/3.5/concepts/mail/index.html | 248 +++++++++++++
main/3.5/concepts/messages/imf.html | 323 +++++++++++++++++
main/3.5/concepts/messages/index.html | 247 +++++++++++++
main/3.5/concepts/messages/mime.html | 334 +++++++++++++++++
main/3.5/concepts/processing/index.html | 229 ++++++++++++
main/3.5/concepts/protocols/esmtp.html | 293 +++++++++++++++
main/3.5/concepts/protocols/imap.html | 509 ++++++++++++++++++++++++++
main/3.5/concepts/protocols/index.html | 256 +++++++++++++
main/3.5/concepts/protocols/jmap.html | 230 ++++++++++++
main/3.5/concepts/protocols/lmtp.html | 276 ++++++++++++++
main/3.5/concepts/protocols/pop.html | 398 ++++++++++++++++++++
main/3.5/concepts/protocols/smtp.html | 426 ++++++++++++++++++++++
main/3.5/concepts/storage/index.html | 229 ++++++++++++
main/3.5/concepts/user/index.html | 393 ++++++++++++++++++++
main/3.5/customization/index.html | 226 ++++++++++++
main/3.5/development/index.html | 228 ++++++++++++
main/3.5/development/logging.html | 307 ++++++++++++++++
main/3.5/index.html | 302 ++++++++++++++++
main/3.5/servers/15-minute-demo.html | 618 ++++++++++++++++++++++++++++++++
main/3.5/servers/5-minute-demo.html | 392 ++++++++++++++++++++
main/3.5/servers/demo.html | 263 ++++++++++++++
main/3.5/servers/distributed.html | 229 ++++++++++++
main/3.5/servers/index.html | 363 +++++++++++++++++++
main/3.5/servers/local.html | 229 ++++++++++++
main/3.5/servers/redundant.html | 229 ++++++++++++
main/3.5/servers/run.html | 385 ++++++++++++++++++++
sitemap.xml | 119 ++++++
55 files changed, 9255 insertions(+)
diff --git a/.asf.yaml b/.asf.yaml
new file mode 100644
index 0000000..4532579
--- /dev/null
+++ b/.asf.yaml
@@ -0,0 +1,9 @@
+#
+# See documentation for the options here
+# https://cwiki.apache.org/confluence/display/INFRA/git+-+.asf.yaml+features
+#
+
+# Staging and publishing profile for yourproject-website.git:
+staging:
+ profile: ~
+ whoami: asf-staging
\ No newline at end of file
diff --git a/404.html b/404.html
new file mode 100644
index 0000000..15e34fb
--- /dev/null
+++ b/404.html
@@ -0,0 +1,107 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Page Not Found :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="/_/css/site.css">
+ </head>
+ <body class="status-404">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-explore is-active" data-panel="explore">
+ <ul class="components">
+ <li class="component">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-latest">
+ <a href="/main/3.5/index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="/main/3.5/index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Page Not Found</h1>
+<div class="paragraph">
+<p>The page you’re looking for does not exist. It may have been moved.</p>
+</div>
+<div class="paragraph">
+<p>If you arrived on this page by clicking on a link, please notify the owner of the site that the link is broken.
+If you typed the URL of this page manually, please double check that you entered the address correctly.</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="/_/js/site.js"></script>
+<script async src="/_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/_/css/site.css b/_/css/site.css
new file mode 100644
index 0000000..a1c67af
--- /dev/null
+++ b/_/css/site.css
@@ -0,0 +1,3 @@
+@font-face{font-family:Roboto;font-style:normal;font-weight:400;src:local("Roboto Regular"),local("Roboto-Regular"),url(../font/roboto-latin-400.woff2) format("woff2"),url(../font/roboto-latin-400.woff) format("woff")}@font-face{font-family:Roboto;font-style:italic;font-weight:400;src:local("Roboto Italic"),local("Roboto-Italic"),url(../font/roboto-latin-400italic.woff2) format("woff2"),url(../font/roboto-latin-400italic.woff) format("woff")}@font-face{font-family:Roboto;font-style:norma [...]
+
+/*! Adapted from the GitHub style by Vasily Polovnyov <va...@whiteants.net> */.hljs-comment,.hljs-quote{color:#998;font-style:italic}.hljs-keyword,.hljs-selector-tag,.hljs-subst{color:#333;font-weight:500}.hljs-literal,.hljs-number,.hljs-tag .hljs-attr,.hljs-template-variable,.hljs-variable{color:teal}.hljs-doctag,.hljs-string{color:#d14}.hljs-section,.hljs-selector-id,.hljs-title{color:#900;font-weight:500}.hljs-subst{font-weight:400}.hljs-class .hljs-title,.hljs-type{color:#458;font-wei [...]
\ No newline at end of file
diff --git a/_/font/roboto-latin-400.woff b/_/font/roboto-latin-400.woff
new file mode 100644
index 0000000..69c8825
Binary files /dev/null and b/_/font/roboto-latin-400.woff differ
diff --git a/_/font/roboto-latin-400.woff2 b/_/font/roboto-latin-400.woff2
new file mode 100644
index 0000000..1a53701
Binary files /dev/null and b/_/font/roboto-latin-400.woff2 differ
diff --git a/_/font/roboto-latin-400italic.woff b/_/font/roboto-latin-400italic.woff
new file mode 100644
index 0000000..b940dbc
Binary files /dev/null and b/_/font/roboto-latin-400italic.woff differ
diff --git a/_/font/roboto-latin-400italic.woff2 b/_/font/roboto-latin-400italic.woff2
new file mode 100644
index 0000000..2741d4f
Binary files /dev/null and b/_/font/roboto-latin-400italic.woff2 differ
diff --git a/_/font/roboto-latin-500.woff b/_/font/roboto-latin-500.woff
new file mode 100644
index 0000000..8699258
Binary files /dev/null and b/_/font/roboto-latin-500.woff differ
diff --git a/_/font/roboto-latin-500.woff2 b/_/font/roboto-latin-500.woff2
new file mode 100644
index 0000000..6362d7f
Binary files /dev/null and b/_/font/roboto-latin-500.woff2 differ
diff --git a/_/font/roboto-latin-500italic.woff b/_/font/roboto-latin-500italic.woff
new file mode 100644
index 0000000..b794d20
Binary files /dev/null and b/_/font/roboto-latin-500italic.woff differ
diff --git a/_/font/roboto-latin-500italic.woff2 b/_/font/roboto-latin-500italic.woff2
new file mode 100644
index 0000000..0ff2f81
Binary files /dev/null and b/_/font/roboto-latin-500italic.woff2 differ
diff --git a/_/font/roboto-mono-latin-400.woff b/_/font/roboto-mono-latin-400.woff
new file mode 100644
index 0000000..c41382c
Binary files /dev/null and b/_/font/roboto-mono-latin-400.woff differ
diff --git a/_/font/roboto-mono-latin-400.woff2 b/_/font/roboto-mono-latin-400.woff2
new file mode 100644
index 0000000..53d4b50
Binary files /dev/null and b/_/font/roboto-mono-latin-400.woff2 differ
diff --git a/_/font/roboto-mono-latin-500.woff b/_/font/roboto-mono-latin-500.woff
new file mode 100644
index 0000000..ba8ff09
Binary files /dev/null and b/_/font/roboto-mono-latin-500.woff differ
diff --git a/_/font/roboto-mono-latin-500.woff2 b/_/font/roboto-mono-latin-500.woff2
new file mode 100644
index 0000000..ec09ab1
Binary files /dev/null and b/_/font/roboto-mono-latin-500.woff2 differ
diff --git a/_/img/back.svg b/_/img/back.svg
new file mode 100644
index 0000000..bf7d30e
--- /dev/null
+++ b/_/img/back.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="100" height="100" viewBox="0 0 100 100"><path d="M50.001 9.9L9.9 50 50 90.1l5.656-5.655-30.435-30.442H90.1v-8.006H25.222l30.435-30.44z"/></svg>
\ No newline at end of file
diff --git a/_/img/caret.svg b/_/img/caret.svg
new file mode 100644
index 0000000..1af41bc
--- /dev/null
+++ b/_/img/caret.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30"><path d="M10.187 3l14 12-14 12z" fill="#c1c1c1" stroke="#c1c1c1" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></svg>
\ No newline at end of file
diff --git a/_/img/chevron.svg b/_/img/chevron.svg
new file mode 100644
index 0000000..40e962a
--- /dev/null
+++ b/_/img/chevron.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30"><path d="M3.67 6.59L1.455 8.615 15 23.375l13.545-14.76L26.33 6.59 15 18.76z" fill="#5d5d5d"/></svg>
\ No newline at end of file
diff --git a/_/img/close.svg b/_/img/close.svg
new file mode 100644
index 0000000..b4a8088
--- /dev/null
+++ b/_/img/close.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><path d="M12.736 87.264l74.528-74.528m-74.528 0l74.528 74.528" fill="none" stroke="#222" stroke-width="8"/></svg>
\ No newline at end of file
diff --git a/_/img/home-o.svg b/_/img/home-o.svg
new file mode 100644
index 0000000..95d193b
--- /dev/null
+++ b/_/img/home-o.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><g fill="none" stroke="#222" stroke-width="4"><path d="M50.02 13.576l-28.58 25.54-.02 47.345h21.506l.025-25.166H57.05l.025 25.166H78.62l.02-47.31-28.62-25.575z"/><path d="M63.815 25.904v-9.217h8.657V33.64zM21.439 39.116l-9.982 8.92m77.125 0l-9.943-8.885"/></g></svg>
\ No newline at end of file
diff --git a/_/img/home.svg b/_/img/home.svg
new file mode 100644
index 0000000..4e96b35
--- /dev/null
+++ b/_/img/home.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><g stroke="#222" stroke-width="4"><path d="M50.02 13.576l-28.58 25.54-.02 47.345h21.506l.025-25.166H57.05l.025 25.166H78.62l.02-47.31-28.62-25.575z" fill="#222" fill-rule="evenodd"/><path d="M63.815 25.904v-9.217h8.657V33.64z" fill="#222" fill-rule="evenodd"/><path d="M21.439 39.116l-9.982 8.92m77.125 0l-9.943-8.885" fill="none"/></g></svg>
\ No newline at end of file
diff --git a/_/img/menu.svg b/_/img/menu.svg
new file mode 100644
index 0000000..8b43b2e
--- /dev/null
+++ b/_/img/menu.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><path d="M35 19.772h55" fill="none" stroke="#222" stroke-width="8" stroke-opacity=".941"/><path fill="#222" d="M10 12.272h15v15H10z"/><path d="M43 63.678h45" fill="none" stroke="#222" stroke-width="5" stroke-opacity=".941"/><path fill="#222" d="M23 58.677h10v10H23z"/><path d="M43 82.727h45" fill="none" stroke="#222" stroke-width="5" stroke-opacity=".941"/><path fill="#222" d="M23 77.727h10v10H23z"/><path d="M43 44.628h45" fill [...]
\ No newline at end of file
diff --git a/_/js/site.js b/_/js/site.js
new file mode 100644
index 0000000..fecfc4f
--- /dev/null
+++ b/_/js/site.js
@@ -0,0 +1,5 @@
+!function(){"use strict";var s=/^sect(\d)$/,n=document.querySelector(".nav-container"),i=document.querySelector(".nav-toggle");i.addEventListener("click",function(e){if(i.classList.contains("is-active"))return r(e);var t=document.documentElement;t.classList.add("is-clipped--nav"),i.classList.add("is-active"),n.classList.add("is-active"),t.addEventListener("click",r),v(e)}),n.addEventListener("click",v);var c,o,l,d=n.querySelector("[data-panel=menu]");function e(){var e,t,n=window.locatio [...]
+!function(){"use strict";var e=document.querySelector("aside.toc.sidebar");if(e){if(document.querySelector("body.-toc"))return e.parentNode.removeChild(e);var t=parseInt(e.dataset.levels||2);if(!(t<0)){for(var d,n,o,c,s=document.querySelector("article.doc"),i=[],r=0;r<=t;r++)i.push(r?".sect"+r+">h"+(r+1)+"[id]":"h1[id].sect0");if(n=i.join(","),o=s,!(d=[].slice.call((o||document).querySelectorAll(n))).length)return e.parentNode.removeChild(e);var l={},u=d.reduce(function(e,t){var n=docume [...]
+!function(){"use strict";var o=document.querySelector("article.doc"),t=document.querySelector(".toolbar");function i(e){return e&&(~e.indexOf("%")?decodeURIComponent(e):e).slice(1)}function c(e){e&&(window.location.hash="#"+this.id,e.preventDefault()),window.scrollTo(0,function e(t,n){return o.contains(t)?e(t.offsetParent,t.offsetTop+n):n}(this,0)-t.getBoundingClientRect().bottom)}window.addEventListener("load",function e(t){var n,o;(n=i(window.location.hash))&&(o=document.getElementById [...]
+!function(){"use strict";var t,e=document.querySelector(".page-versions .version-menu-toggle");e&&(t=document.querySelector(".page-versions"),e.addEventListener("click",function(e){t.classList.toggle("is-active"),e.stopPropagation()}),document.documentElement.addEventListener("click",function(){t.classList.remove("is-active")}))}();
+document.addEventListener("DOMContentLoaded",function(){var t=Array.prototype.slice.call(document.querySelectorAll(".navbar-burger"),0);0!==t.length&&t.forEach(function(e){e.addEventListener("click",function(t){t.stopPropagation(),e.classList.toggle("is-active"),document.getElementById(e.dataset.target).classList.toggle("is-active"),document.documentElement.classList.toggle("is-clipped--navbar")})})});
\ No newline at end of file
diff --git a/_/js/vendor/highlight.js b/_/js/vendor/highlight.js
new file mode 100644
index 0000000..997c06d
--- /dev/null
+++ b/_/js/vendor/highlight.js
@@ -0,0 +1 @@
+!function(){var e,n,a={};e=function(i){var a,g=[],r=Object.keys,y={},u={},w=!0,n=/^(no-?highlight|plain|text)$/i,b=/\blang(?:uage)?-([\w-]+)\b/i,t=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,M="</span>",O="Could not find the language '{}', did you forget to load/include a language module?",C={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0},l="of and for in not or if then".split(" ");function x(e){return e.replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">")}function m(e){ret [...]
\ No newline at end of file
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..ce6d938
--- /dev/null
+++ b/index.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html>
+<meta charset="utf-8">
+<link rel="canonical" href="https://james.apache.org/main/3.5/index.html">
+<script>location="main/3.5/index.html"</script>
+<meta http-equiv="refresh" content="0; url=main/3.5/index.html">
+<meta name="robots" content="noindex">
+<title>Redirect Notice</title>
+<h1>Redirect Notice</h1>
+<p>The page you requested has been relocated to <a href="main/3.5/index.html">https://james.apache.org/main/3.5/index.html</a>.</p>
diff --git a/main/3.5/community/index.html b/main/3.5/community/index.html
new file mode 100644
index 0000000..25a0dd1
--- /dev/null
+++ b/main/3.5/community/index.html
@@ -0,0 +1,228 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Apache James Community :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Community</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Apache James Community</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/glossary.html b/main/3.5/concepts/glossary.html
new file mode 100644
index 0000000..0f876eb
--- /dev/null
+++ b/main/3.5/concepts/glossary.html
@@ -0,0 +1,301 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Glossary :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <a class="nav-link" href="glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Concepts</a></li>
+ <li><a href="glossary.html">Glossary</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Glossary</h1>
+<div id="email_client" class="dlist">
+<dl>
+<dt class="hdlist1">Email Client</dt>
+<dd>
+<p>Any software application that acts as a POP Client or an IMAP Client.</p>
+</dd>
+<dt class="hdlist1"><a href="messages/imf.html" class="page">IMF</a></dt>
+<dd>
+<p><strong>Internet Message Format</strong> (IMF) is the base specification that defines the
+syntax of an email message.</p>
+</dd>
+</dl>
+</div>
+<div id="email_server" class="dlist">
+<dl>
+<dt class="hdlist1">Email Server (or Mail Server)</dt>
+<dd>
+<p>Any host that contains a sofware application that acts as a POP Server, an
+IMAP Server, or an MTA.</p>
+</dd>
+<dt class="hdlist1">IMAP</dt>
+<dt class="hdlist1">IMAP Client</dt>
+<dd>
+<p>One of the main actors in an email system that implements the IMAP protocol. The client
+acts as a slave, in that it mirrors the state of the IMAP Server.</p>
+</dd>
+<dt class="hdlist1">IMAP Server</dt>
+<dd>
+<p>One of the main actors in an email system that implements the IMAP protocol. The server
+acts as the master, in that it dictates the state that will be seen on each of the
+IMAP Clients.</p>
+</dd>
+<dt class="hdlist1">JMAP</dt>
+<dt class="hdlist1"><a href="messages/mime.html" class="page">MIME</a></dt>
+<dd>
+<p><strong>Multipurpose Internet Mail Extension</strong> (MIME) is a specification that extends
+IMF, defining most of the "advanced" features of email.</p>
+</dd>
+</dl>
+</div>
+<div id="mta" class="dlist">
+<dl>
+<dt class="hdlist1">MTA</dt>
+<dd>
+<p>A <strong>Mail Transfer Agent</strong> (MTA) is a host that is capable of providing a mail
+transport service compliant with the SMTP protocol.</p>
+</dd>
+<dt class="hdlist1">MUA</dt>
+<dd>
+<p>A <strong>Mail User Agent</strong> (MUA) is either an agent that hands over a message to an initial
+MTA on the originating side of a transmission, or receives the message from the
+final MTA on the terminating side of a transmission. It is in some respects similar to
+an MTA, but is local in scope and does not necessarily follow a known specification.</p>
+</dd>
+<dt class="hdlist1"><a href="protocols/smtp.html" class="page">SMTP</a></dt>
+<dd>
+<p><strong>Simple Mail Transfer Protocol</strong> (SMTP) is a protocol that specifies how to transmit
+a valid email message from one MTA to another.</p>
+</dd>
+<dt class="hdlist1">POP</dt>
+<dt class="hdlist1">POP Client</dt>
+<dd>
+<p>One of the main actors in an email system that implements the POP protocol. The client
+is on the host that is closest to the user from a logical perspective, and is the host
+to which messages are delivered from the POP Server.</p>
+</dd>
+<dt class="hdlist1">POP Server</dt>
+<dd>
+<p>One of the main actors in an email system that implements the POP protocol. The server
+is part of the host that is logically farthest from the user. It is the host on which
+the messages are initially delivered, and where they temporarily await collection by
+the POP Client.</p>
+</dd>
+</dl>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/index.html b/main/3.5/concepts/index.html
new file mode 100644
index 0000000..9504727
--- /dev/null
+++ b/main/3.5/concepts/index.html
@@ -0,0 +1,304 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Apache James Core Concepts :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Concepts</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Apache James Core Concepts</h1>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>The core domain of Apache James is intimitely related to email communications.
+Therefore this section is divided into topics that deal with the various
+aspect of email systems.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#emails">Email Messages</a></p>
+</li>
+<li>
+<p><a href="#protocols">Transmission Protocols</a></p>
+</li>
+<li>
+<p><a href="#mailbox">Mailbox and Email Storage</a></p>
+</li>
+<li>
+<p><a href="#processing">Email Processing</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="emails"><a class="anchor" href="#emails"></a>Email Messages</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Electronic Mail (often written as "e-mail" or "email") is a means of
+exchanging messages over a data network. In our context, it is obvious
+that we mean "electronic mail" and not "postal mail", so we usually just
+write "mail".</p>
+</div>
+<div class="paragraph">
+<p><a href="mail/index.html" class="page">Email messages</a> are based on a few specifications
+that are not easy to digest, so we make an effort to provide a simplified
+model.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="protocols"><a class="anchor" href="#protocols"></a>Transmission Protocols</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Emails are only useful because people can communicate with each other.
+To allow for this, obviously there must be a means of transmitting messages
+from one user to another. A number of different protocols have emerged to
+handle the various different requirements of using email in a practical
+manner. The most common <a href="protocols/index.html" class="page">transmission protocols</a>
+are SMTP, POP, and IMAP. More recently JMAP is an interesting protocol
+that merits attention.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="mailbox"><a class="anchor" href="#mailbox"></a>Mailbox and Email Storage</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Email would not be very useful if, like in <a href="https://www.youtube.com/watch?v=0TiqXFssKMY">Mission Impossible</a>,
+a message would self-destruct immediately after being read.
+For those of us who are not secret agents, we generally prefer to keep
+a record of those messages that we receive. For this reason we need a means
+of <a href="storage/index.html" class="page">storing messages</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="processing"><a class="anchor" href="#processing"></a>Email Processing</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>There are many ways to peel a potato. James has its own particular
+<a href="processing/index.html" class="page">model for processing mail</a>,
+based mostly on the concept of a "Mailet". The idea of Mailet-based
+processing was heavily inspired by the <a href="https://en.wikipedia.org/wiki/Java_servlet">Servlet</a>
+concept.</p>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/mail/index.html b/main/3.5/concepts/mail/index.html
new file mode 100644
index 0000000..bb37629
--- /dev/null
+++ b/main/3.5/concepts/mail/index.html
@@ -0,0 +1,248 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>All About Emails :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">All About Emails</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">All About Emails</h1>
+<div class="paragraph">
+<p>The <a href="https://en.wikipedia.org/wiki/History_of_email">history of email</a> has resulted
+in a convoluted patchwork of standards and practices, which can be very difficult
+to understand and decipher. Fortunately, James has your back.</p>
+</div>
+<div class="paragraph">
+<p>We have built up our own view of emails that allows us to process messages in a
+consistent and comprehensible way.</p>
+</div>
+<div class="paragraph">
+<p>To help you understand how James approaches emails, we have divided this section
+up into the following parts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="../messages/index.html" class="page">Email Messages</a></p>
+</li>
+<li>
+<p><a href="../protocols/index.html" class="page">Transmission Protocols</a></p>
+</li>
+</ul>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/messages/imf.html b/main/3.5/concepts/messages/imf.html
new file mode 100644
index 0000000..4648ce0
--- /dev/null
+++ b/main/3.5/concepts/messages/imf.html
@@ -0,0 +1,323 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Internet Message Format :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Messages</a></li>
+ <li><a href="imf.html">IMF</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Internet Message Format</h1>
+<div class="sect1">
+<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>What people casually call "email" actually refers more specifically to a
+text message written in a specified format called
+<a href="https://en.wikipedia.org/wiki/Email">"Internet Message Format"</a> or "IMF".
+After the first IMF specification was published in 1982 there was no looking back.
+Email took the world by storm. Today it is arguably the most prevalent means of
+communicating with a distant party.</p>
+</div>
+<div class="paragraph">
+<p>IMF is very basic, and is limited to only specifying a syntax for text messages.
+For the transmission of images, audio, or other types of data we need to make
+use of the <a href="#mail/messages/mime.adoc" class="page unresolved">MIME</a> specification.
+Although IMF forms the base standard upon which
+email is based, email today is rarely used without MIME. We therefore consider
+for practical purposes that an email message is essentially the equivalent of
+a MIME message.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The specifications for Internet Message Format (IMF) form the basis of what we commonly
+call "email".</p>
+</div>
+<div class="sect2">
+<h3 id="_rfc822"><a class="anchor" href="#_rfc822"></a>RFC822</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc822">RFC822</a> ("Standard for the Format of ARPA Internet Text Messages")
+was the original standard that defined the format of an email. It was obsoleted by
+<a href="#_rfc2822">RFC2822</a>. The definition of an email under this standard was an attempt to take the lessons
+learned from the ARPANET and extend the use of text messaging to a broader context.</p>
+</div>
+<div class="paragraph">
+<p>Electronic mail messages are defined as having contents and an envelope. The contents
+consist of header fields and, optionally, a body. The body is nothing more than
+a (potentially empty) sequence of lines of text.</p>
+</div>
+<div class="paragraph">
+<p>Although this sounds like a an extremely simple concept, to get two completely separate systems
+to agree and understand each other is a surprisingly complex problem that most people
+today take for granted. Most of RFC822 deals with the nitty-gritty of formatting and parsing
+this type of text message.</p>
+</div>
+<div class="paragraph">
+<p>This specification deals with the headers, additionally relating them to the sending and
+forwarding of messages. The body content is dealt with in <a href="#RFC2045">[RFC2045]</a></p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc2822"><a class="anchor" href="#_rfc2822"></a>RFC2822</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2822">RFC2822</a> ("Internet Message Format")
+obsoletes <a href="#_rfc822">RFC822</a>, and was obsoleted by <a href="#_rfc5322">RFC5322</a>.</p>
+</div>
+<div class="paragraph">
+<p>The standard builds on RFC822, but limits its scope to only the sytax of the
+message, and obsoletes much of what was defined by RFC822. The envelope was
+split into a separate specification, <a href="#RFC2821">[RFC2821]</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc5322"><a class="anchor" href="#_rfc5322"></a>RFC5322</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc5322">RFC5322</a> ("Internet Message Format")
+was published in 2008.
+It obsoletes <a href="#_rfc2822">RFC2822</a> and is currently the specification still actually in use.</p>
+</div>
+<div class="paragraph">
+<p>It builds on RFC2822, updating it to the then-current context and obsoleting
+outdated parts of RFC2822.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_james_model"><a class="anchor" href="#_james_model"></a>James Model</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>While the general description of IMF is not sufficient for building a complex
+system like James, the technical specifications are unfortunately
+very messy and overly-complex due to their history and the context in which
+they were developed.</p>
+</div>
+<div class="paragraph">
+<p>Since modern-day messaging almost always requires MIME, and since the
+separation between IMF and MIME is not really useful from a usage perspective,
+James considers an "email" to be both IMF- an MIME-compliant. For all intents
+and purposes, James does not consider the concept of IMF in its domain model.</p>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/messages/index.html b/main/3.5/concepts/messages/index.html
new file mode 100644
index 0000000..8efbfb6
--- /dev/null
+++ b/main/3.5/concepts/messages/index.html
@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Email Messages :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Messages</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Email Messages</h1>
+<div class="paragraph">
+<p>An email message is essentially a simple text message that is communicated
+from one party to another. It is no miracle that two unknown parties are
+able to communicate; rather rather we can thank a set of standards that
+allow any two unrelated systems to process an email even if the system owners
+do not know each other.</p>
+</div>
+<div class="paragraph">
+<p>The two most important standards upon which today’s emails are based
+are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="imf.html" class="page">Internet Mail Format</a> (IMF)</p>
+</li>
+<li>
+<p><a href="mime.html" class="page">Multipurpose Internet Mail Extensions</a> (MIME)</p>
+</li>
+</ul>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/messages/mime.html b/main/3.5/concepts/messages/mime.html
new file mode 100644
index 0000000..f93303a
--- /dev/null
+++ b/main/3.5/concepts/messages/mime.html
@@ -0,0 +1,334 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Multipurpose Internet Mail Extensions :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imf.html">IMF</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Messages</a></li>
+ <li><a href="mime.html">MIME</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Multipurpose Internet Mail Extensions</h1>
+<div class="sect1">
+<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The base format of an email message is <a href="imf.html" class="page">Internet Message Format"</a>,
+but most contemporary messages use a format called
+<a href="https://en.wikipedia.org/wiki/MIME">"Multipurpose Internet Mail Extensions"</a>.
+MIME specifies how to extend a valid IMF message, dealing with character encodings,
+various file formats, and many other odds and ends that make email what it is today.</p>
+</div>
+<div class="paragraph">
+<p>A user of email rarely has to be concerned with the MIME specifications. Usually the
+communications system should take care of all the nitty gritty, and even then MIME
+processing is usually at a very low level. For this reason, the blissfully simple
+conception of a simple "email" is usually just fine from the perspective of a user
+and even in most cases for a developer.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Multipurpose Internet Mail Extensions, or just MIME, functions much like an extension
+to IMF in order to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Add different character sets for internationalization</p>
+</li>
+<li>
+<p>Allow for processing of media types other than plain text</p>
+</li>
+</ul>
+</div>
+<div class="sect2">
+<h3 id="_rfc2045"><a class="anchor" href="#_rfc2045"></a>RFC2045</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2045">RFC2045</a> ("Multipurpose Internet Mail Extensions
+Part One: Format of Internet Message Bodies")
+describes the message body format of an email. It is part of a serious of MIME
+specifications including <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2047">RFC2047</a>, <a href="#_rfc2048">RFC2048</a>, and <a href="#_rfc2049">RFC2049</a>.
+This particular document in the series specifies the various headers that
+are used to describe the structure of a MIME message.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc2046"><a class="anchor" href="#_rfc2046"></a>RFC2046</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2046">RFC2046</a> ("Multipurpose Internet Mail Extensions
+Part Two: Media Types") describes the various MIME media types, such as
+plain text, images, videos, etc. It is part of the serious of MIME specifications
+that includes <a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2047">RFC2047</a>, <a href="#_rfc2048">RFC2048</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc2047"><a class="anchor" href="#_rfc2047"></a>RFC2047</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2047">RFC2047</a> ("MIME Part Three:
+Message Header Extensions for Non-ASCII Text") describes, as the
+title indicates, header extensions for non-ASCII text. It is part
+of the series of MIME specifications that includes
+<a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2048">RFC2048</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc2048"><a class="anchor" href="#_rfc2048"></a>RFC2048</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2048">RFC2048</a> ("Multipurpose Internet Mail Extensions
+Part Four: Registration Procedures") describes the procedure for registering a MIME
+type. It is not directly relevant to James, but is part of the MIME series that includes
+<a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2047">RFC2047</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
+</div>
+<div class="paragraph">
+<p>This specification was obsoleted by <a href="https://tools.ietf.org/html/rfc4288">RFC4288</a>
+(which itself was obsoleted by <a href="https://tools.ietf.org/html/rfc6838">RFC6838</a>) and
+<a href="https://tools.ietf.org/html/rfc4289">RFC4289</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc2049"><a class="anchor" href="#_rfc2049"></a>RFC2049</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2049">RFC2049</a> ("Multipurpose Internet Mail Extensions
+Part Five: Conformance Criteria and Examples") mainly describes what portions of MIME
+must be supported by a conformant MIME implementation. It is part of the series that includes
+<a href="#_rfc2045">RFC2045</a>, <a href="#_rfc2046">RFC2046</a>, <a href="#_rfc2047">RFC2047</a>, and <a href="#_rfc2049">RFC2049</a>.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_james_model"><a class="anchor" href="#_james_model"></a>James Model</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>While a general, non-technical description of MIME is useful for most users
+and developers, it is not sufficient for building a complex system like James. Meanwhile,
+the technical specifications are unfortunately very messy and overly-complex due to
+their history and the context in which they were developed. To make dealing with
+emails possible and practical, James has defined its own version of what it means
+to be an email.</p>
+</div>
+<div class="paragraph">
+<p>(TODO need a reference, please!)</p>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/processing/index.html b/main/3.5/concepts/processing/index.html
new file mode 100644
index 0000000..5c79946
--- /dev/null
+++ b/main/3.5/concepts/processing/index.html
@@ -0,0 +1,229 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Mail Processing Domain Model :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <a class="nav-link" href="index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Processing</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Mail Processing Domain Model</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/protocols/esmtp.html b/main/3.5/concepts/protocols/esmtp.html
new file mode 100644
index 0000000..1057753
--- /dev/null
+++ b/main/3.5/concepts/protocols/esmtp.html
@@ -0,0 +1,293 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>SMTP Service Extensions (ESMTP) :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Protocols</a></li>
+ <li><a href="esmtp.html">ESMTP</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">SMTP Service Extensions (ESMTP)</h1>
+<div class="sect1">
+<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><a href="https://en.wikipedia.org/wiki/Extended_SMTP">SMTP Service Extensions</a>, written as "ESMTP"
+and characterized in the literature as "Extended SMTP" (and sometimes "Enhanced SMTP")
+is a framework for extending SMTP. Extensions are expected to be registered with
+IANA and negotiated between the client and server.</p>
+</div>
+<div class="paragraph">
+<p>Whereas SMTP mandates that a session begins with the "HELO" command, ESMTP requires
+the "EHLO" (extended hello) command. Note that nowadays even "standard" SMTP uses
+EHLO as its initial greeting, and only falls back to HELO, so in a sense every
+SMTP server has effectively become an ESMTP server.</p>
+</div>
+<div class="paragraph">
+<p>The ESMTP specification itself no longer actually exists independently of SMTP.
+We mention it here mostly for completion, historical purposes, and as a reference
+to a concept that is still very much in use, albeit now as a concept internal to
+SMTP.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_rfc1425"><a class="anchor" href="#_rfc1425"></a>RFC1425</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1425">RFC1425</a> ("SMTP Service Extensions") is the originally
+published ESMTP specification. It was obsoleted by <a href="#_rfc1651">RFC1651</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc1651"><a class="anchor" href="#_rfc1651"></a>RFC1651</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1651">RFC1651</a> ("SMTP Service Extensions") obsoletes <a href="#_rfc1425">RFC1425</a>
+and was itself obsoleted by <a href="#_rfc1869">RFC1869</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc1869"><a class="anchor" href="#_rfc1869"></a>RFC1869</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1869">RFC1869</a> ("SMTP Service Extensions") obsoletes <a href="#_rfc1651">RFC1651</a>, and
+is essentially the final specification in which ESMTP was defined separately from SMTP. When this
+spec was obsoleted by <a href="smtp.html#RFC2821" class="page">RFC2821</a>, it was incorporated into the
+SMTP specification.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, because ESMTP defines an extension framework for SMTP</p>
+</li>
+<li>
+<p><strong><a href="lmtp.html" class="page">LMTP</a></strong>, as LMTP is defined by the ESMTP framework</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/protocols/imap.html b/main/3.5/concepts/protocols/imap.html
new file mode 100644
index 0000000..9eaef64
--- /dev/null
+++ b/main/3.5/concepts/protocols/imap.html
@@ -0,0 +1,509 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Internet Message Access Protocol (IMAP) :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="pop.html">POP</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Protocols</a></li>
+ <li><a href="imap.html">IMAP</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Internet Message Access Protocol (IMAP)</h1>
+<div class="sect1">
+<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><a href="https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol">Internet Message Access Protocol</a>,
+or IMAP, is a protocol used by email clients to retrieve
+<a href="../messages/index.html" class="page">email messages</a> from a <a href="../glossary.html#email_server" class="page">mail server</a>.
+One could say that it is effectively in competition with <a href="pop.html" class="page">POP</a>
+because it accomplishes a function similar in nature, and most clients will force you
+to choose one or the other..
+These days, the natural choice of protocol tends to be IMAP rather than POP.</p>
+</div>
+<div class="paragraph">
+<p>The main difference between IMAP and POP is that messages are kept on the server, which
+keeps a kind of master reference. Instead of transferring the message to the client,
+only an image, or copy of the message is kept locally. When the client synchronises with
+the state of the server, it will tend to mimic that state. So if a new message is stored
+in a mailbox, it will appear on the client, or if a message is deleted from the server,
+it will also be deleted from the client.</p>
+</div>
+<div class="paragraph">
+<p>The user can control the state of server from the client by adding, deleting, or moving
+messages between folders. The user can also add folders from the client, the state of which
+will be stored on the server.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_imap"><a class="anchor" href="#_imap"></a>IMAP</h3>
+<div class="paragraph">
+<p>Apparently, no official specification exists for the original IMAP.
+It became a specification with the publication of <a href="#_imap2">IMAP2</a></p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_imap2"><a class="anchor" href="#_imap2"></a>IMAP2</h3>
+<div class="sect3">
+<h4 id="_rfc1064"><a class="anchor" href="#_rfc1064"></a>RFC1064</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1064">RFC1064</a> ("Interactive Mail Access Protocol - Version 2")
+was the original IMAP2 specification, published in 1988. The specification was obsoleted
+by <a href="#_rfc1176">RFC1176</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rfc1176"><a class="anchor" href="#_rfc1176"></a>RFC1176</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1176">RFC1176</a> ("Interactive Mail Access Protocol - Version 2")
+provides various, somewhat minor updates to <a href="#_rfc1064">RFC1064</a>. This specification was supseded by
+the first IMAP3 specification, <a href="#_rfc1203">RFC1203</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_imap3"><a class="anchor" href="#_imap3"></a>IMAP3</h3>
+<div class="sect3">
+<h4 id="_rfc1203"><a class="anchor" href="#_rfc1203"></a>RFC1203</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1203">RFC1203</a> ("Interactive Mail Access Protocol - Version 3")
+obsoletes <a href="#_rfc1064">RFC1064</a>, and presumedly also <a href="#_rfc1176">RFC1176</a>.
+It appears to be the only version of IMAP3 that was published. Apparently, IMAP3 is a rare
+version, and was never really adopted by the marketplace.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_imap4"><a class="anchor" href="#_imap4"></a>IMAP4</h3>
+<div class="sect3">
+<h4 id="_rfc1730"><a class="anchor" href="#_rfc1730"></a>RFC1730</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1730">RFC1730</a> ("Interactive Message Access Protocol - Version 4")
+was the first version of IMAP4, published in 1994. Note that the "M" in the name was changed
+from "Mail" to "Message".
+It was obsoleted two years later by <a href="#_rfc2060">RFC2060</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rfc2060"><a class="anchor" href="#_rfc2060"></a>RFC2060</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2060">RFC2060</a> ("Interactive Message Access Protocol - Version 4rev1")
+was the first revision of the original IMAP4 specification. It was obsoleted by <a href="#_rfc3501">RFC3501</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rfc3501"><a class="anchor" href="#_rfc3501"></a>RFC3501</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc3501">RFC3501</a> ("Interactive Message Access Protocol - Version 4rev1")
+is the current IMAP4 standard in use. Though the name is confusing, is was the second revision since
+the publication of the original IMAP4 specification. This version was published in 2003. Likely,
+there has not been a need to update this specification as instead updates are published as extensions.
+Extensions to IMAP have been published as recently as in 2018.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_extensions_to_rfc3501"><a class="anchor" href="#_extensions_to_rfc3501"></a>Extensions to RFC3501</h4>
+<div class="paragraph">
+<p>For brevity, we simply refence a number of extentions to RFC3501:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc4466">RFC4466</a> ("Collected Extensions to IMAP4 ABNF")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc4469">RFC4469</a> ("Internet Message Access Protocol (IMAP) CATENATE Extension")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc4551">RFC4551</a> ("IMAP Extension for Conditional STORE Operation or Quick Flag Changes Resynchronization")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc5032">RFC5032</a> ("WITHIN Search Extension to the IMAP Protocol")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc5182">RFC5182</a> ("IMAP Extension for Referencing the Last SEARCH Result")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc5738">RFC5738</a> ("IMAP Support for UTF-8")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc6186">RFC6186</a> ("Use of SRV Records for Locating Email Submission/Access Services")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc6858">RFC6858</a> ("Simplified POP and IMAP Downgrading for Internationalized Email")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc7817">RFC7817</a> ("Updated Transport Layer Security (TLS) Server Identity Check Procedure for Email-Related Protocols")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc8314">RFC8314</a> ("Cleartext Considered Obsolete: Use of Transport Layer Security (TLS) for Email Submission and Access")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc8437">RFC8437</a> ("IMAP UNAUTHENTICATE Extension for Connection Reuse")</p>
+</li>
+<li>
+<p><a href="https://tools.ietf.org/html/rfc8474">RFC8474</a> ("IMAP Extension for Object Identifiers")</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>IMAP is related to…​</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong><a href="pop.html" class="page">POP</a></strong> as a "competing" protocol</p>
+</li>
+<li>
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, as the client will provide the functionality of
+an IMAP Client and connect to the IMAP Server</p>
+</li>
+<li>
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, in that messages will normally be
+delivered to the IMAP Server via SMTP.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_try_it"><a class="anchor" href="#_try_it"></a>Try It!</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can connect manually to James using the IMAP protocol by opening a
+telnet session.</p>
+</div>
+<div class="paragraph">
+<p>Requirements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Run the long demo (without stopping)</p>
+</li>
+<li>
+<p>Telnet</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Approximate duration: 5 minutes</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Note: extra lines are inserted below to help show you what you need to type.</p>
+</div>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-telnet hljs" data-lang="telnet">$ telnet 127.0.0.1 143
+Trying 127.0.0.1...
+Connected to localhost.
+Escape character is '^]'.
+* OK JAMES IMAP4rev1 Server Server faef5a990fbb is ready.
+
+01 login user01@james.local 1234 <i class="conum" data-value="1"></i><b>(1)</b>
+
+01 OK LOGIN completed.
+
+l list "" "*" <i class="conum" data-value="2"></i><b>(2)</b>
+
+* LIST (\HasNoChildren) "." "INBOX"
+l OK LIST completed.
+
+s select INBOX <i class="conum" data-value="3"></i><b>(3)</b>
+
+* FLAGS (\Answered \Deleted \Draft \Flagged \Seen)
+* 1 EXISTS
+* 1 RECENT
+* OK [UIDVALIDITY 749313882] UIDs valid
+* OK [UNSEEN 1] MailboxMessage 2 is first unseen
+* OK [PERMANENTFLAGS (\Answered \Deleted \Draft \Flagged \Seen \*)] Limited
+* OK [HIGHESTMODSEQ 5] Highest
+* OK [UIDNEXT 2] Predicted next UID
+s OK [READ-WRITE] SELECT completed.
+
+f FETCH 1:* (FLAGS BODY.PEEK[HEADER.FIELDS (SUBJECT)]) <i class="conum" data-value="4"></i><b>(4)</b>
+
+* 1 FETCH (FLAGS (\Seen) BODY[HEADER.FIELDS (SUBJECT)] {75}
+Subject: Test Message
+
+)
+f OK FETCH completed.
+
+d store 1 +FLAGS (\Deleted) <i class="conum" data-value="5"></i><b>(5)</b>
+
+* 1 FETCH (FLAGS (\Deleted \Seen))
+d OK STORE completed.
+
+e expunge <i class="conum" data-value="6"></i><b>(6)</b>
+
+* 1 EXPUNGE
+e OK EXPUNGE completed.
+
+l logout <i class="conum" data-value="7"></i><b>(7)</b></code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>Login as user <code>user01@james.local</code></td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>List the contents of the Mailbox</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>Select <code>INBOX</code> as the current folder</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="4"></i><b>4</b></td>
+<td>Fetch the contents of the INBOX folder, showing only the subject</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="5"></i><b>5</b></td>
+<td>Mark the message for deletion</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="6"></i><b>6</b></td>
+<td>Epunge the INBOX by deleting mails marked for deletion</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="7"></i><b>7</b></td>
+<td>Exit the session</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/protocols/index.html b/main/3.5/concepts/protocols/index.html
new file mode 100644
index 0000000..8f1adf9
--- /dev/null
+++ b/main/3.5/concepts/protocols/index.html
@@ -0,0 +1,256 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Transmission Protocols :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Protocols</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Transmission Protocols</h1>
+<div class="paragraph">
+<p>The true value of email is that any one party can communicate with any
+other party located virtually anywhere. All they need are a common understanding
+of a <a href="../messages/index.html" class="page">message format</a>, and a means of
+transmitting the message.</p>
+</div>
+<div class="paragraph">
+<p>Transmitting email messages between parties requires a mutually-known protocol.
+It turns out that there are several standard protocols used for the
+transmission of email messages, each with a different purpose:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="smtp.html" class="page">Simple Mail Transfer</a></p>
+</li>
+<li>
+<p><a href="pop.html" class="page">Post Office</a></p>
+</li>
+<li>
+<p><a href="imap.html" class="page">Internet Message Access</a></p>
+</li>
+<li>
+<p><a href="jmap.html" class="page">JSON Meta Application</a></p>
+</li>
+<li>
+<p><a href="lmtp.html" class="page">Local Mail Transfer</a></p>
+</li>
+</ul>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/protocols/jmap.html b/main/3.5/concepts/protocols/jmap.html
new file mode 100644
index 0000000..d07b0d0
--- /dev/null
+++ b/main/3.5/concepts/protocols/jmap.html
@@ -0,0 +1,230 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>JSON Meta Application Protocol (JMAP) :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imap.html">IMAP</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Protocols</a></li>
+ <li><a href="jmap.html">JMAP</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">JSON Meta Application Protocol (JMAP)</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/protocols/lmtp.html b/main/3.5/concepts/protocols/lmtp.html
new file mode 100644
index 0000000..49faab3
--- /dev/null
+++ b/main/3.5/concepts/protocols/lmtp.html
@@ -0,0 +1,276 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Local Mail Transfer Protocol (LMTP) :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Protocols</a></li>
+ <li><a href="lmtp.html">LMTP</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Local Mail Transfer Protocol (LMTP)</h1>
+<div class="sect1">
+<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><a href="https://en.wikipedia.org/wiki/Local_Mail_Transfer_Protocol">Local Mail Transfer Protocol</a> ("LMTP")
+is</p>
+</div>
+<div class="paragraph">
+<p>From <a href="#_rfc2033">RFC2033</a>:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>Although LMTP is an alternative protocol to ESMTP, it uses (with a
+few changes) the syntax and semantics of ESMTP. This design permits
+LMTP to utilize the extensions defined for ESMTP. LMTP should be
+used only by specific prior arrangement and configuration, and it
+MUST NOT be used on TCP port 25.</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_rfc2033"><a class="anchor" href="#_rfc2033"></a>RFC2033</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2033">RFC2033</a> ("Local Mail Transfer Protocol") was published
+in 1996, and defines a simplified protocol for local mail delivery mainly inspired by
+<a href="esmtp.html" class="page">ESMTP</a>. It is the first, last, and only specification of its kind.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>LMTP relates to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong><a href="esmtp.html" class="page">ESMTP</a></strong>, as it is a derivative thereof</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/protocols/pop.html b/main/3.5/concepts/protocols/pop.html
new file mode 100644
index 0000000..e0f16a7
--- /dev/null
+++ b/main/3.5/concepts/protocols/pop.html
@@ -0,0 +1,398 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Post Office Protocol (POP) :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Protocols</a></li>
+ <li><a href="pop.html">POP</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Post Office Protocol (POP)</h1>
+<div class="sect1">
+<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <a href="https://en.wikipedia.org/wiki/Post_Office_Protocol">Post Office Protocol</a>,
+or POP, is described in the original specification
+as being "a simple method for workstations to dynamically access mail from
+a <a href="../storage/index.html" class="page">mailbox server</a>" (though interestingly "mailbox server"
+is never actually defined in this specification nor in later specifications. 🤔)</p>
+</div>
+<div class="paragraph">
+<p>POP was proposed as the first non-<a href="smtp.html" class="page">SMTP</a> protocol aimed
+at users for the purpose of retrieving emails stored remotely for local consumption.
+POP was developed in pre-spam days, so was inherently a non-secure protocol.
+It has been updated several times to address several issues, including lack of
+security, so that POP3 is now the current specification.</p>
+</div>
+<div class="paragraph">
+<p>As the name suggests, the protocol is modeled after a post office. The analogy being:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>The various SMTP servers along the transmission chain are like post offices</p>
+</li>
+<li>
+<p>The user’s mail server is the local post office that will dispatch the mail to the recipient</p>
+</li>
+<li>
+<p>The postman is, ummm, well no analogy is perfect 😬</p>
+</li>
+<li>
+<p>The mail gets dropped into the user’s mailbox (though just to make the analogy even
+muddier there is an option to leave a copy on the server)</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Analogies aside, the protocol worked quite well for most users, and is still widely
+in use today.</p>
+</div>
+<div class="paragraph">
+<p>POP requires essentially two pieces, the POP Client and the POP Server. How the
+message gets initially delivered to the POP Server and how a message is managed
+once delivered to the POP Client is out of scope of the POP protocol.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_pop"><a class="anchor" href="#_pop"></a>POP</h3>
+<div class="paragraph">
+<p>POP has been around since the early days of email. The original specification
+<a href="#_rfc918">RFC918</a> was published in 1984.</p>
+</div>
+<div class="sect3">
+<h4 id="_rfc918"><a class="anchor" href="#_rfc918"></a>RFC918</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc918">RFC918</a> ("Post Office Protocol") was the original
+specification published in 1984. The RFC "suggests a simple method for workstations
+to dynamically access mail from a mailbox server."
+Like <a href="smtp.html" class="page">SMTP</a> that came before it, POP is a session-based
+protocol with a handful of defined commands.
+This RFC was obsoleted shortly after its publication by <a href="#_rfc937">RFC937</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_pop2"><a class="anchor" href="#_pop2"></a>POP2</h3>
+<div class="sect3">
+<h4 id="_rfc937"><a class="anchor" href="#_rfc937"></a>RFC937</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc937">RFC937</a> ("Post Office Protocol - Version 2") or more
+commonly "POP2" was a revision of the original <a href="#_rfc918">RFC918</a> specification. POP2 specifies
+connection over port 109, and clarifies that "it is important for the mailbox to be on
+an 'always up' machine and that a workstation may be frequently powered down, or
+otherwise unavailable as an SMTP server." In other words, as the Internet continued to
+evolve, this specification was an attempt to evolve with it.</p>
+</div>
+<div class="paragraph">
+<p>POP2 was replaced by POP3, which was first published as <a href="#_rfc1081">RFC1081</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_pop3"><a class="anchor" href="#_pop3"></a>POP3</h3>
+<div class="sect3">
+<h4 id="_rfc1081"><a class="anchor" href="#_rfc1081"></a>RFC1081</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1081">RFC1081</a> ("Post Office Protocol - Version 3")
+was the first published version of POP3,
+made available in 1988. It adds additional functionality for managing mail, and
+perhaps most importantly, it adds an authentication mechanism. This version was
+obsoleted by <a href="#_rfc1225">RFC1225</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rfc1225"><a class="anchor" href="#_rfc1225"></a>RFC1225</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1225">RFC1225</a> ("Post Office Protocol - Version 3")
+obsoleted <a href="#_rfc1081">RFC1081</a>. It is described as being a "republication" of <a href="#_rfc1081">RFC1081</a>,
+and does not appear to add anything significant. It was obsoleted by
+<a href="#_rfc1460">RFC1460</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rfc1460"><a class="anchor" href="#_rfc1460"></a>RFC1460</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1460">RFC1460</a> ("Post Office Protocol - Version 3")
+provided some relatively minor updates to <a href="#_rfc1225">RFC1225</a>, and was itself obsoleted
+about one year later by <a href="#_rfc1725">RFC1725</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rfc1725"><a class="anchor" href="#_rfc1725"></a>RFC1725</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1725">RFC1725</a> ("Post Office Protocol - Version 3")
+was again a relatively minor update of <a href="#_rfc1460">RFC1460</a>, and was itself obsoleted
+about two years later by <a href="#_rfc1939">RFC1939</a>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_rfc1939"><a class="anchor" href="#_rfc1939"></a>RFC1939</h4>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc1939">RFC1939</a> ("Post Office Protocol - Version 3")
+is the most recent specification of POP3, and is the version in use today.</p>
+</div>
+<div class="paragraph">
+<p>This specification seems to imply that POP3 is used for "simple" transactions,
+and for more "advanced" transactions <a href="imap.html" class="page">IMAP</a> is available.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_pop4"><a class="anchor" href="#_pop4"></a>POP4</h3>
+<div class="paragraph">
+<p>Although there was development on the <a href="http://www.pop4.org/">POP4</a> specification,
+development appears to have stalled for several years, making POP3 the
+still-current protocol.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>POP relates to…​</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong><a href="imap.html" class="page">IMAP</a></strong> as a "competing" protocol</p>
+</li>
+<li>
+<p><strong><a href="../glossary.html#email_client" class="page">Email clients</a></strong>, in that the client acts as a POP Client</p>
+</li>
+<li>
+<p><strong><a href="../storage/index.html" class="page">Storage</a></strong> in that messages are stored temporarily on
+a ???? while awaiting transfer to the client</p>
+</li>
+<li>
+<p><strong><a href="smtp.html" class="page">SMTP</a></strong>, in that messages will normally be
+delivered to the IMAP Server via SMTP.</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/protocols/smtp.html b/main/3.5/concepts/protocols/smtp.html
new file mode 100644
index 0000000..55d883c
--- /dev/null
+++ b/main/3.5/concepts/protocols/smtp.html
@@ -0,0 +1,426 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Simple Mail Transfer Protocol (SMTP) :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Protocols</a></li>
+ <li><a href="smtp.html">SMTP</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Simple Mail Transfer Protocol (SMTP)</h1>
+<div class="sect1">
+<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When the original specification for Simple Mail Transfer Protocol, or SMTP,
+was published almost 40 years ago together with
+<a href="../messages/imf.html" class="page">IMF</a>, email as we know it today was born.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_specifications"><a class="anchor" href="#_specifications"></a>Specifications</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_rfc821"><a class="anchor" href="#_rfc821"></a>RFC821</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc821">RFC821</a> ("Simple Mail Transfer Protocol")
+was the original SMTP specification published in 1982.
+It was obsoleted by <a href="#_rfc2821">RFC2821</a> in 2001.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc2821"><a class="anchor" href="#_rfc2821"></a>RFC2821</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc2821">RFC2821</a> ("Simple Mail Transfer Protocol") replaced
+<a href="#_rfc821">RFC821</a>. It was itself replaced by <a href="#RFC5321">[RFC5321]</a> in 2008.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_rfc_5321"><a class="anchor" href="#_rfc_5321"></a>RFC 5321</h3>
+<div class="paragraph">
+<p><a href="https://tools.ietf.org/html/rfc5321">RFC5321</a> is the currently used standard for
+"Simple Mail Transfer Protocol", or "SMTP". Published in 2008, it is "a specification of the basic
+protocol for Internet electronic mail transport". If you are interested in all
+the gory details, we recommend that you read this document.</p>
+</div>
+<div class="paragraph">
+<p>This specification has many dependencies with <a href="../messages/imf.html" class="page">IMF</a>,
+<a href="../messages/mime.html" class="page">MIME</a>, and other technical concepts, which can quickly
+become utterly confusing.
+Here, we provide a very short and simplified description of those portions of the
+specification that we felt were interesting enough to repeat here.</p>
+</div>
+<div class="paragraph">
+<p>As the spec mentions, "SMTP transports a mail object", a mail object being described
+as an object that contains both an envelope and content. An SMTP client connects
+to a server and communicates via a session. Both client and server provide a
+mail transport service, and are therefore act as "Mail Transfer Agents", or
+"MTAs". A mail originates and terminates with a "Mail User Agent" ("MUA").
+On the originating side, a MUA may, for instance, collect mail to be transmitted
+by a user and hand it off to an MTA. On the terminating side, an MTA would
+hand a mail off to an MUA.</p>
+</div>
+<div class="paragraph">
+<p>"SMTP sessions are stateful, with both parties carefully maintaining a
+common view of the current state." The session is initiated by the client,
+which establishes a two-way channel to an SMTP server. The session must either
+close successful (or with a failure message), else delivery is considered to
+have failed.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_related_concepts"><a class="anchor" href="#_related_concepts"></a>Related Concepts</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>SMTP relates to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><strong><a href="../messages/index.html" class="page">Email messages</a></strong>, in that the SMTP protocol exists to transfer
+messages from one host to another</p>
+</li>
+<li>
+<p><strong><a href="../glossary.html#mta" class="page">MTA</a></strong>, in that the very nature of SMTP is about specifying how a message
+gets transferred from one MTA to another</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_try_it"><a class="anchor" href="#_try_it"></a>Try It!</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can try speaking SMTP with your demo server by connecting to it using telnet. It would not work on a real world server as it would requires encrypted traffic. See "using openssl to talk to your server"</p>
+</div>
+<div class="paragraph">
+<p>Requirements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Run the long demo (without stopping)</p>
+</li>
+<li>
+<p>Telnet</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Approximate duration: 5 minutes</p>
+</div>
+<div class="exampleblock">
+<div class="content">
+<div class="paragraph">
+<p>Note: extra lines are inserted below to help show you what you need to type.</p>
+</div>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-telnet hljs" data-lang="telnet">$ telnet 127.0.0.1 25 <i class="conum" data-value="1"></i><b>(1)</b>
+
+Trying 127.0.0.1...
+Connected to localhost.
+Escape character is '^]'.
+220 JAMES Linagora's SMTP awesome Server
+
+ehlo test <i class="conum" data-value="2"></i><b>(2)</b>
+
+250-9a2fe463e592 Hello test [172.17.0.1])
+250-PIPELINING
+250-ENHANCEDSTATUSCODES
+250 8BITMIME
+
+mail from: <user02@james.local> <i class="conum" data-value="3"></i><b>(3)</b>
+
+250 2.1.0 Sender <user02@james.local> OK
+
+rcpt to: <user01@james.local> <i class="conum" data-value="4"></i><b>(4)</b>
+
+250 2.1.5 Recipient <user01@james.local> OK
+
+data <i class="conum" data-value="5"></i><b>(5)</b>
+
+354 Ok Send data ending with <CRLF>.<CRLF>
+
+Subject: Test Message <i class="conum" data-value="5"></i><b>(5)</b>
+<i class="conum" data-value="6"></i><b>(6)</b>
+This is just a test. <i class="conum" data-value="7"></i><b>(7)</b>
+. <i class="conum" data-value="8"></i><b>(8)</b>
+
+250 2.6.0 Message received
+
+quit <i class="conum" data-value="9"></i><b>(9)</b></code></pre>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>Connect to the James server using the SMTP protocol via telnet.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>Initiate the SMTP session.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="3"></i><b>3</b></td>
+<td>Indicate that you want to send a mail from user02@james.local.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="4"></i><b>4</b></td>
+<td>Indicate that the mail should be sent to user01@james.local.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="5"></i><b>5</b></td>
+<td>Enter the subject.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="6"></i><b>6</b></td>
+<td>Enter a blank line.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="7"></i><b>7</b></td>
+<td>Enter some text. You can enter multiples lines if you like.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="8"></i><b>8</b></td>
+<td>When you have completed the message, enter a line with only a "." and no other text.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="9"></i><b>9</b></td>
+<td>End the session.</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>If you set up Thunderbird to connect to the server, you can confirm that the mail
+has indeed arrived in the mailbox of user01@james.local.</p>
+</div>
+<div class="paragraph">
+<p>Pretty cool! Good thing we have James so we don’t have to always send emails manually.</p>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/storage/index.html b/main/3.5/concepts/storage/index.html
new file mode 100644
index 0000000..a842a07
--- /dev/null
+++ b/main/3.5/concepts/storage/index.html
@@ -0,0 +1,229 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Mailboxes and Email Storage :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <a class="nav-link" href="index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">Storage</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Mailboxes and Email Storage</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/concepts/user/index.html b/main/3.5/concepts/user/index.html
new file mode 100644
index 0000000..94f3a5c
--- /dev/null
+++ b/main/3.5/concepts/user/index.html
@@ -0,0 +1,393 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>James User Model :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="2">
+ <a class="nav-link" href="index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../../index.html">Apache James Reference Book</a></li>
+ <li><a href="../index.html">Concepts</a></li>
+ <li><a href="index.html">User Model</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">James User Model</h1>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>For clarity, we have defined various roles for actors who interact
+with <a href="#servers/index.adoc" class="page unresolved">James servers</a> in one way or another.
+The deliverables we make available are produced with these roles in mind.
+Note that any given person may play more than one role, even at the same
+time.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#_user">User</a></p>
+</li>
+<li>
+<p><a href="#_operator">Operator</a></p>
+</li>
+<li>
+<p><a href="#_integrator">Integrator</a></p>
+</li>
+<li>
+<p><a href="#_developer">Developer</a></p>
+</li>
+<li>
+<p><a href="#_contributor">Contributor</a></p>
+</li>
+<li>
+<p><a href="#_committer">Committer</a></p>
+</li>
+<li>
+<p><a href="#_pmc_member">PMC Member</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_user"><a class="anchor" href="#_user"></a>User</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>A <strong>User</strong> simply uses email without any notion of what server is providing the service.</p>
+</div>
+<div class="paragraph">
+<p>More precisely, in typical cases a User will have an email client for reading and writing email. The
+<a href="../glossary.html" class="page">email client</a> will connect to the James server via
+<a href="#mail/protocols/smtp.adoc" class="page unresolved">SMTP</a>,
+<a href="#mail/protocols/pop.adoc" class="page unresolved">POP</a>, or
+<a href="#mail/protocols/imap.adoc" class="page unresolved">IMAP</a>.
+The User will have no indication anywhere that the server is a James server.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_operator"><a class="anchor" href="#_operator"></a>Operator</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>An <strong>Operator</strong> installs and runs James for the benefit of Users.</p>
+</div>
+<div class="paragraph">
+<p>The Operator does not compile any Java code, and does not require any software
+development environment.</p>
+</div>
+<div class="paragraph">
+<p>Apache James offers Operators a range of servers for various use cases, including:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>A <a href="#server/basic/index.adoc" class="page unresolved">Basic Server</a> ideal for busy Operators who
+are interested in an easy-to-use self-hosting solution, but who may not have the
+time to gain deep expertise</p>
+</li>
+<li>
+<p>An <a href="#server/advanced/index.adoc" class="page unresolved">Advanced Server</a> well-suited for Operators with
+advanced skills and resources who are not daunted by getting their hands dirty
+with configurations or using built-in extensions</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_integrator"><a class="anchor" href="#_integrator"></a>Integrator</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>An <strong>Integrator</strong> has some expertise with Java or a JVM-based language. Based
+on this expertise the Integrator can perform more advanced server configurations and may
+develop <a href="#xxx.adoc" class="page unresolved">Extensions</a> to customize the behavior of a James server.</p>
+</div>
+<div class="paragraph">
+<p>An Integrator does <strong>not</strong> need to download the source code or compile James.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_developer"><a class="anchor" href="#_developer"></a>Developer</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>A <strong>Developer</strong> uses the James codebase, executes a build using the provided
+build system (Maven), may edit the source code and deploy the built artifacts.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_contributor"><a class="anchor" href="#_contributor"></a>Contributor</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>A <strong>Contributor</strong> refers to anyone involved with the Apache James community by:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Filing an issue on the <a href="https://issues.apache.org/jira/secure/Dashboard.jspa">issue tracking system</a></p>
+</li>
+<li>
+<p>Posting a question on the <a href="https://james.apache.org/mail.html">mailing list</a>
+or on the <a href="https://gitter.im/apache/james-project">gitter channel</a></p>
+</li>
+<li>
+<p>Submitting a <a href="https://github.com/apache/james-project/pulls">pull request</a> (PR)</p>
+</li>
+<li>
+<p>Fixes, refines and writes documentation</p>
+</li>
+<li>
+<p>Writes a tutorial or article about James</p>
+</li>
+<li>
+<p>Otherwise generally helps the James Community in any other way not listed here</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_committer"><a class="anchor" href="#_committer"></a>Committer</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>A <strong>Committer</strong> is granted special rights (according to
+<a href="https://www.apache.org/dev/committers.html">Apache practices</a>)
+to participate in the development of James by:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Accepting (being assigned) issues in the <a href="https://issues.apache.org/jira/secure/Dashboard.jspa">issue tracking system</a></p>
+</li>
+<li>
+<p>Merging code into the <a href="https://github.com/apache/james-project">git repository</a></p>
+</li>
+<li>
+<p>Being granted a voice when voting matters arise</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_pmc_member"><a class="anchor" href="#_pmc_member"></a>PMC Member</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>A <strong>PMC</strong> (Project Management Committee) Member
+is a Committer who is also a member of the PMC, as stipulated by
+<a href="https://www.apache.org/dev/pmc.html">Apache rules</a>.</p>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../../_/js/site.js"></script>
+<script async src="../../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/customization/index.html b/main/3.5/customization/index.html
new file mode 100644
index 0000000..0884773
--- /dev/null
+++ b/main/3.5/customization/index.html
@@ -0,0 +1,226 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Apache James Customization :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Customization</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Apache James Customization</h1>
+
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/development/index.html b/main/3.5/development/index.html
new file mode 100644
index 0000000..97a0708
--- /dev/null
+++ b/main/3.5/development/index.html
@@ -0,0 +1,228 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Apache James Developer Guide :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Developer Guide</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Apache James Developer Guide</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/development/logging.html b/main/3.5/development/logging.html
new file mode 100644
index 0000000..8fcb804
--- /dev/null
+++ b/main/3.5/development/logging.html
@@ -0,0 +1,307 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Logging in Apache James :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="logging.html">Logging in Apache James</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Logging in Apache James</h1>
+<div id="preamble">
+<div class="sectionbody">
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+This information targets developers.
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Logging is very important when running a software.
+Most of the time people use logs for debugging and troubleshooting issues in production.
+In Apache James we leverage a logging facade for logging <a href="http://www.slf4j.org/">Slf4j</a> .
+Please see the documentation for exact details.</p>
+</div>
+<div class="paragraph">
+<p>In a typical application logs are stored for a specific period.
+This can be 1 day, 1 week, etc.</p>
+</div>
+<div class="paragraph">
+<p>Some other typical scenarios include:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Rotating logs periodically.</p>
+</li>
+<li>
+<p>Shipping logs centrally.</p>
+</li>
+<li>
+<p>Saving some logging messages to other files / end devices</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>By leveraging a logging facade like Slf4j, the end user has the ability to use different logging back ends and achieve the above requirements.</p>
+</div>
+<div class="paragraph">
+<p>Logging is something we do to help the people running our code.
+We also help ourselves when they encounter bugs, and they need to share information with us for a fix.
+As developers, we should be mindful of the logging statements.
+We should also be mindful about the performance implications of logging and not abuse it.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_loggers_used_in_code"><a class="anchor" href="#_loggers_used_in_code"></a>Loggers used in code</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>You can define a logger using a string or a class.
+For common loggers it’s ok to use a string name.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java"> private static final Logger LOGGER = LoggerFactory.getLogger("org.apache.james.CONFIGURATION");
+ private static final Logger LOGGER = LoggerFactory.getLogger(JamesServerMain.class);</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Loggers can be hierarchical.
+This helps when we build a logger from a class name, and we use package structure to drive the logger hierarchy.</p>
+</div>
+<div class="paragraph">
+<p>The most useful loggers should to be documented below.
+Please maintain this list of loggers.</p>
+</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1">org.apache.james.CONFIGURATION</dt>
+<dd>
+<p>It is used to log events related to configuration loading and updating.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/index.html b/main/3.5/index.html
new file mode 100644
index 0000000..612e04d
--- /dev/null
+++ b/main/3.5/index.html
@@ -0,0 +1,302 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Welcome :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="servers/index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="servers/demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="servers/5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="servers/15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="servers/local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="servers/redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="servers/distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="index.html" class="home-link is-current"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Welcome</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Welcome</h1>
+<div class="paragraph">
+<p>Welcome to the Apache James Reference Documentation! These documents are for version 3.5 of James.</p>
+</div>
+<div class="paragraph">
+<p>Apache James is a flexible email platform that provides out-of-the-box mail servers that you can start
+using in production immediately.
+James runs on the JVM and is highly customizable.</p>
+</div>
+<div class="paragraph">
+<p>This Reference Book is divided into the following Parts:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="concepts/index.html" class="page">James Core Concepts</a></p>
+<div class="ulist">
+<ul>
+<li>
+<p>These are the core concepts that describe what James is all about.
+Start here if you want to learn more about what James can do
+and how it is designed.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><a href="servers/index.html" class="page">James Servers</a></p>
+<div class="ulist">
+<ul>
+<li>
+<p>We provide a few out-of-the-box servers that you can
+choose from depending on your needs. Start here if you just
+want to get up and running quickly with a working production-grade mail server.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><a href="customization/index.html" class="page">Customization</a></p>
+<div class="ulist">
+<ul>
+<li>
+<p>Shows how you can customize any James server with the
+functionalities that you need.
+Check out this section if you have special business or technical
+needs and are interested in a custom solution.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><a href="development/index.html" class="page">James Developer Guide</a></p>
+<div class="ulist">
+<ul>
+<li>
+<p>A guide aimed at experienced developers, describing
+how you can assemble your own specialized server.</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><a href="community/index.html" class="page">James Community</a></p>
+<div class="ulist">
+<ul>
+<li>
+<p>All about the Apache James community, and how you can be
+part of this active and dynamic group, too!</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Please note that this Reference Documentation is a <strong>living document</strong>. It is subject to change. You are currently reading version 3.5. If you find anything that is unclear, unfinished, or confusing, please do not hestiate to <a href="community/index.html" class="page">lend us a hand</a>.</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../_/js/site.js"></script>
+<script async src="../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/15-minute-demo.html b/main/3.5/servers/15-minute-demo.html
new file mode 100644
index 0000000..145c7fe
--- /dev/null
+++ b/main/3.5/servers/15-minute-demo.html
@@ -0,0 +1,618 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Long Demo :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Servers</a></li>
+ <li><a href="demo.html">Demo</a></li>
+ <li><a href="15-minute-demo.html">Long Demo</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Long Demo</h1>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this demo (~15 minutes), we will set up a runing James demo using a prepared Docker image.
+We will then test the server by connecting with an email client. Finally, we
+will connect to the server via the REST-based Admin API.</p>
+</div>
+<div class="paragraph">
+<p>Requirements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Docker</p>
+</li>
+<li>
+<p>curl</p>
+</li>
+<li>
+<p>Thunderbird client (optional)</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_set_up_the_demo_server"><a class="anchor" href="#_set_up_the_demo_server"></a>Set up the demo server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Before starting the server, because we will be connecting to the Admin API we need to set some configuration parameters.
+We will create a <code>webadmin.properties</code> file that James will use in order to allow us to connect to the API.</p>
+</div>
+<div class="paragraph">
+<p>Run this command to create the <code>webadmin.properties</code> file:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">printf 'enabled=true\nport=8000\nhost=localhost' >> webadmin.properties</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Explanation:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>enabled=true</code> instructs James to run the Admin API service</p>
+</li>
+<li>
+<p><code>port=8000</code> configures the Admin API to be made available via port 8000</p>
+</li>
+<li>
+<p><code>host=localhost</code> configures the Admin API to respond on localhost</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Now run the James demo server using this command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run -d -p "25:25" -p "143:143" -p "127.0.0.1:8000:8000" -v $(pwd)/webadmin.properties:/root/conf/webadmin.properties --name james linagora/james-jpa-sample:3.4.0</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Explanation:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>docker run</code> runs the provided image with the given parameters</p>
+</li>
+<li>
+<p>The <code>-d</code> parameter runs the container in "detached" mode</p>
+</li>
+<li>
+<p><code>-p "25:25" -p "143:143"</code> attaches the image ports to the ports 25 (SMTP) and 143 (IMAP) on the host machine</p>
+</li>
+<li>
+<p>`-p "127.0.0.1:8000:8000" attaches the port 8000 to localhost on the host machine to allow us to connect to the Admin API</p>
+</li>
+<li>
+<p><code>-v $(pwd)/webadmin.properties:/root/conf/webadmin.properties</code> mounts the webadmin.properties file to configure the Admin API</p>
+</li>
+<li>
+<p>The <code>--name james</code> parameter gives the running container a name to make it easier to manipulate</p>
+</li>
+<li>
+<p><code>linagora/james-jpa-sample:3.4.0</code> is the image that is used for this demo</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Docker will pull the image and start the container.</p>
+</div>
+<div class="sidebarblock">
+<div class="content">
+<div class="paragraph">
+<p>To run commands using the James CLI, you can use the running container via Docker:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>docker exec james java -jar /root/james-cli.jar \
+ -h \<<HOST>> -p \<<PORT>> \<<COMMAND>></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In this demo, we are using host 127.0.0.1 and port 9999, so every command looks like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>docker exec james java -jar /root/james-cli.jar \
+ -h 127.0.0.1 -p 9999 \<<COMMAND>></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Host 127.0.0.1 is of course localhost, and the use of port 9999 is completely arbitrary.</p>
+</div>
+<div class="paragraph">
+<p>To make this demo a little easier to use, set this up as a bash script by copying and pasting this script:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">printf '#!/bin/bash\n\ndocker exec james java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 $@' >> james ; chmod +x james</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>As an example, list all the domains currently in use by James:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should notice that a default domain, james.local, has been created</p>
+</div>
+<div class="paragraph">
+<p>List all the current users:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should see users <code>user01@james.local</code>, <code>user02@james.local</code>, and <code>user03@james.local</code>.</p>
+</div>
+<div class="paragraph">
+<p>Create a new "test.local" domain:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addDomain test.local</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>List the domains again to ensure that "test.local" has successfully been added:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Add the user "testuser" to the "test.local" domain with password "password":</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addUser testuser@test.local password</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should now see your newly created user:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_connect_to_the_server_with_an_email_client"><a class="anchor" href="#_connect_to_the_server_with_an_email_client"></a>Connect to the server with an email client</h2>
+<div class="sectionbody">
+<div class="sidebarblock">
+<div class="content">
+<div class="paragraph">
+<p>For this demo, we will use Thunderbird, as it is available in multiple languages
+on Windows, Mac, and Linux.</p>
+</div>
+<div class="paragraph">
+<p>Go to <a href="https://www.thunderbird.net" class="bare">https://www.thunderbird.net</a> to download Thunderbird.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>After you have installed Thunderbird,
+<a href="https://support.mozilla.org/en-US/kb/manual-account-configuration">manually set up an account</a>
+for user01@james.local using the following parameters:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Account name: user01</p>
+</li>
+<li>
+<p>Your name: User 01</p>
+</li>
+<li>
+<p>Email address: user01@james.local</p>
+</li>
+<li>
+<p>SMTP server name: localhost</p>
+</li>
+<li>
+<p>SMTP port: 25</p>
+</li>
+<li>
+<p>SMTP connection security: none</p>
+</li>
+<li>
+<p>SMTP authentication: password</p>
+</li>
+<li>
+<p>IMAP server name: localhost</p>
+</li>
+<li>
+<p>IMAP user name: user01@james.local</p>
+</li>
+<li>
+<p>IMAP port: 143</p>
+</li>
+<li>
+<p>IMAP connection security: none</p>
+</li>
+<li>
+<p>IMAP authentication: none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Repeat the above for testuser@test.local:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Account name: testuser</p>
+</li>
+<li>
+<p>Your name: Test User</p>
+</li>
+<li>
+<p>Email address: testuser@test.local</p>
+</li>
+<li>
+<p>SMTP server name: localhost</p>
+</li>
+<li>
+<p>SMTP port: 25</p>
+</li>
+<li>
+<p>SMTP connection security: none</p>
+</li>
+<li>
+<p>SMTP authentication: password</p>
+</li>
+<li>
+<p>IMAP server name: localhost</p>
+</li>
+<li>
+<p>IMAP user name: testuser@test.local</p>
+</li>
+<li>
+<p>IMAP port: 143</p>
+</li>
+<li>
+<p>IMAP connection security: none</p>
+</li>
+<li>
+<p>IMAP authentication: none</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Now have fun sending emails back and forth to yourself. :-)
+But don’t spend all day doing this. You have too much work to do.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_connect_to_the_server_via_the_admin_api"><a class="anchor" href="#_connect_to_the_server_via_the_admin_api"></a>Connect to the server via the Admin API</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>We will use curl to connect to localhost on port 8000, as the Admin API
+is made available on this port.</p>
+</div>
+<div class="paragraph">
+<p>List the available domains:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl http://localhost:8000/domains</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should see a response similar to this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-json hljs" data-lang="json">[
+ "edfce41c55e6",
+ "james.linagora.com",
+ "james.local",
+ "localhost",
+ "test.local",
+ "172.17.0.2"
+]</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Test that a domain exists:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -I -X GET http://localhost:8000/domains/test.local</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should see an empty <code>204</code> response, which means "yes, this domain does exist".</p>
+</div>
+<div class="paragraph">
+<p>Delete our test domain:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -X DELETE http://localhost:8000/domains/test.local</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Now retest <code>test.local</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -I -X GET http://localhost:8000/domains/test.local</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This time you will receive a <code>404</code> code because the <code>test.local</code> domain no longer exists.</p>
+</div>
+<div class="paragraph">
+<p>Documentation for the webadmin is available at: <a href="http://james.apache.org/server/manage-webadmin.html" class="bare">http://james.apache.org/server/manage-webadmin.html</a></p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_optional"><a class="anchor" href="#_optional"></a>Optional</h2>
+<div class="sectionbody">
+<div class="ulist">
+<ul>
+<li>
+<p>Connect manually with SMTP (~5 minutes)</p>
+</li>
+<li>
+<p>Connect manually with POP (~5 minutes)</p>
+</li>
+<li>
+<p>Connect manually with IMAP (~5 minutes)</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_stop_the_demo"><a class="anchor" href="#_stop_the_demo"></a>Stop the demo</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To shutdown the server:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code>docker stop james ; docker rm james</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>That’s all, folks!</p>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/5-minute-demo.html b/main/3.5/servers/5-minute-demo.html
new file mode 100644
index 0000000..8c3c56d
--- /dev/null
+++ b/main/3.5/servers/5-minute-demo.html
@@ -0,0 +1,392 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Short Demo :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Servers</a></li>
+ <li><a href="demo.html">Demo</a></li>
+ <li><a href="5-minute-demo.html">Short Demo</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Short Demo</h1>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>In this short demo (~5 minutes), we will set up a runing James demo very quickly
+using a prepared Docker image.
+Then you will add a domain, and a user account within that domain.</p>
+</div>
+<div class="paragraph">
+<p>Requirements:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Docker</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_set_up_the_demo_server"><a class="anchor" href="#_set_up_the_demo_server"></a>Set up the demo server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To begin, run the James demo server using Docker:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run -d -p "25:25" -p "143:143" --name james linagora/james-jpa-sample:3.4.0</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Explanation:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>docker run</code> runs the provided image with the given parameters</p>
+</li>
+<li>
+<p>The <code>-d</code> parameter runs the container in "detached" mode</p>
+</li>
+<li>
+<p><code>-p "25:25" -p "143:143"</code> attaches the image ports to the ports 25 (SMTP) and 143 (IMAP) on the host machine</p>
+</li>
+<li>
+<p>The <code>--name james</code> parameter gives the running container a name to make it easier to manipulate</p>
+</li>
+<li>
+<p><code>linagora/james-jpa-sample:3.4.0</code> is the image that is used for this demo</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Docker will pull the image and start the container.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_connect_via_the_cli"><a class="anchor" href="#_connect_via_the_cli"></a>Connect via the CLI</h2>
+<div class="sectionbody">
+<div class="sidebarblock">
+<div class="content">
+<div class="paragraph">
+<p>To run commands using the James CLI, you can use the running container via Docker:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>docker exec james java -jar /root/james-cli.jar \
+ -h \<<HOST>> -p \<<PORT>> \<<COMMAND>></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In this demo, we are using host 127.0.0.1 and port 9999, so every command looks like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>docker exec james java -jar /root/james-cli.jar \
+ -h 127.0.0.1 -p 9999 \<<COMMAND>></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Host 127.0.0.1 is of course localhost, and the use of port 9999 is completely arbitrary.</p>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>To make this demo a little easier to use, set this up as a bash script by copying and pasting this script:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">printf '#!/bin/bash\n\ndocker exec james java -jar /root/james-cli.jar -h 127.0.0.1 -p 9999 $@' >> james ; chmod +x james</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>As an example, list all the domains currently in use by James:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should notice that a default domain, james.local, has been created</p>
+</div>
+<div class="paragraph">
+<p>List all the current users:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should see users <code>user01@james.local</code>, <code>user02@james.local</code>, and <code>user03@james.local</code>.</p>
+</div>
+<div class="paragraph">
+<p>Create a new "test.local" domain:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addDomain test.local</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>List the domains again to ensure that "test.local" has successfully been added:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listDomains</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Add the user "testuser" to the "test.local" domain with password "password":</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james addUser testuser@test.local password</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>You should now see your newly created user:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./james listUsers</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>And that’s a wrap!</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_stop_the_server"><a class="anchor" href="#_stop_the_server"></a>Stop the server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>To stop the demo:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker stop james ; docker rm james</code></pre>
+</div>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/demo.html b/main/3.5/servers/demo.html
new file mode 100644
index 0000000..8bbffc0
--- /dev/null
+++ b/main/3.5/servers/demo.html
@@ -0,0 +1,263 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Server Demo :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Servers</a></li>
+ <li><a href="demo.html">Demo</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Server Demo</h1>
+<div class="paragraph">
+<p>The James Demo Server sets up a light-weight, disposable mail server
+so you can try it out easily on your own local machine.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="5-minute-demo.html" class="page">Short demo</a> (~5 minutes)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Set up a demo server</p>
+</li>
+<li>
+<p>Create a new user with the CLI</p>
+</li>
+</ul>
+</div>
+</li>
+<li>
+<p><a href="15-minute-demo.html" class="page">Long demo</a> (~15 minutes)</p>
+<div class="ulist">
+<ul>
+<li>
+<p>Same steps as above</p>
+</li>
+<li>
+<p>Interact with the server via the Admin API</p>
+</li>
+<li>
+<p>Test the server with an email client</p>
+</li>
+</ul>
+</div>
+</li>
+</ul>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/distributed.html b/main/3.5/servers/distributed.html
new file mode 100644
index 0000000..005bb56
--- /dev/null
+++ b/main/3.5/servers/distributed.html
@@ -0,0 +1,229 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>James Distributed Mail Server :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Servers</a></li>
+ <li><a href="distributed.html">Distributed</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">James Distributed Mail Server</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/index.html b/main/3.5/servers/index.html
new file mode 100644
index 0000000..a25fe04
--- /dev/null
+++ b/main/3.5/servers/index.html
@@ -0,0 +1,363 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Apache James Mail Servers :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Servers</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Apache James Mail Servers</h1>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>James offers a number of ready-made Mail Servers. The servers are intended
+for those with typcial use cases, and can be used out-of-the-box. These
+servers have been tested and verified so you can get set up quickly with
+a production-grade Mail Server that you can use with confidence.</p>
+</div>
+<div class="paragraph">
+<p>The available James Servers are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#demo">James Demo Mail Server</a></p>
+</li>
+<li>
+<p><a href="#local">James Local Mail Server</a></p>
+</li>
+<li>
+<p><a href="#redundant">James Redundant Mail Server</a></p>
+</li>
+<li>
+<p><a href="#distributed">James Distributed Mail Server</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="demo"><a class="anchor" href="#demo"></a>James Demo Server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <a href="demo.html" class="page">James Server Demo</a> is intended for those who just want
+to give James a quick spin on their local machine.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="local"><a class="anchor" href="#local"></a>James Local Mail Server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you are not sure which server you should be using, then
+you probably ought to be using the <a href="local.html" class="page"><strong>Local Server</strong></a>.
+This server uses the local file system to store emails, which tends
+to considerably simplify the system. To safeguard your emails, you
+only need a simple generic backup solution that works with a data
+volume.</p>
+</div>
+<div class="paragraph">
+<p>This server is intended to be the simplest to set up and use in production.
+It has the least amount of dependencies and complexities. If you do not yet
+have a huge amount of emails to process, then usually the simplicity is
+well worth the loss of some functionality. The last thing you need is
+to have to resolve difficult issues on a production server when you have not
+yet acquired the requisite knowledge to deal with those issues. Using the
+<a href="local.html" class="page"><strong>Local Server</strong></a> will help you reduce the risk of running into
+production issues.</p>
+</div>
+<div class="paragraph">
+<p>This server is:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Suggested for use with smaller deployments</p>
+</li>
+<li>
+<p>Appropriate for use by most operators</p>
+</li>
+<li>
+<p>The preferred choice for most installations</p>
+</li>
+<li>
+<p>Endowed with fewer dependencies, which makes it simpler and less risky to use in production</p>
+</li>
+<li>
+<p>Only dependent on your local file system for data storage, so very easy to manage</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="redundant"><a class="anchor" href="#redundant"></a>James Redundant Mail Server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When your requirements start to get a little more serious
+(let’s say in the tens of millions of emails), then you may want to
+start to consider using the <a href="redundant.html" class="page"><strong>Redundant Server</strong></a>.</p>
+</div>
+<div class="paragraph">
+<p>This server provides data redundancy so that it can stay live at
+all times, even in the rare case that your data gets corrupted.</p>
+</div>
+<div class="paragraph">
+<p>This server is:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Intended for use by experienced operators only</p>
+</li>
+<li>
+<p>Used for mid-sized to large deployments</p>
+</li>
+<li>
+<p>More performant than the Minimal and Basic Server, but also more complex</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="distributed"><a class="anchor" href="#distributed"></a>James Distributed Mail Server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <a href="distributed.html" class="page"><strong>Distributed Server</strong></a> is a heavy-duty industrial
+enterprise mail server.</p>
+</div>
+<div class="paragraph">
+<p>This server is:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Intended for use by experts only</p>
+</li>
+<li>
+<p>Use for large-scale distributed deployments</p>
+</li>
+<li>
+<p>The most feature-rich server, but also by far the most complex</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/local.html b/main/3.5/servers/local.html
new file mode 100644
index 0000000..f17e023
--- /dev/null
+++ b/main/3.5/servers/local.html
@@ -0,0 +1,229 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>James Local Mail Server :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Servers</a></li>
+ <li><a href="local.html">Local</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">James Local Mail Server</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/redundant.html b/main/3.5/servers/redundant.html
new file mode 100644
index 0000000..b2b2a7d
--- /dev/null
+++ b/main/3.5/servers/redundant.html
@@ -0,0 +1,229 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>James Redundant Mail Server :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="index.html">Servers</a></li>
+ <li><a href="redundant.html">Redundant</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">James Redundant Mail Server</h1>
+<div class="paragraph">
+<p>(TODO)</p>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/main/3.5/servers/run.html b/main/3.5/servers/run.html
new file mode 100644
index 0000000..89634e1
--- /dev/null
+++ b/main/3.5/servers/run.html
@@ -0,0 +1,385 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <title>Run James in Production :: Apache James</title>
+ <meta name="generator" content="Antora 2.3.3">
+ <link rel="stylesheet" href="../../../_/css/site.css">
+ </head>
+ <body class="article">
+<header class="header">
+ <nav class="navbar">
+ <div class="navbar-brand">
+ <a class="navbar-item" href="https://james.apache.org">Apache James</a>
+ <button class="navbar-burger" data-target="topbar-nav">
+ <span></span>
+ <span></span>
+ <span></span>
+ </button>
+ </div>
+ <div id="topbar-nav" class="navbar-menu">
+ <div class="navbar-end">
+ <a class="navbar-item" href="#">Home</a>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Products</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Product A</a>
+ <a class="navbar-item" href="#">Product B</a>
+ <a class="navbar-item" href="#">Product C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Services</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Service A</a>
+ <a class="navbar-item" href="#">Service B</a>
+ <a class="navbar-item" href="#">Service C</a>
+ </div>
+ </div>
+ <div class="navbar-item has-dropdown is-hoverable">
+ <a class="navbar-link" href="#">Resources</a>
+ <div class="navbar-dropdown">
+ <a class="navbar-item" href="#">Resource A</a>
+ <a class="navbar-item" href="#">Resource B</a>
+ <a class="navbar-item" href="#">Resource C</a>
+ </div>
+ </div>
+ <div class="navbar-item">
+ <span class="control">
+ <a class="button is-primary" href="#">Download</a>
+ </span>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+<div class="body">
+<div class="nav-container" data-component="main" data-version="3.5">
+ <aside class="nav">
+ <div class="panels">
+<div class="nav-panel-menu is-active" data-panel="menu">
+ <nav class="nav-menu">
+ <h3 class="title"><a href="../index.html">Apache James Reference Book</a></h3>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/index.html">Concepts</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/user/index.html">User Model</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/messages/index.html">Messages</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/imf.html">IMF</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/messages/mime.html">MIME</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="../concepts/protocols/index.html">Protocols</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/smtp.html">SMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/pop.html">POP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/imap.html">IMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/jmap.html">JMAP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/esmtp.html">ESMTP</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="../concepts/protocols/lmtp.html">LMTP</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/storage/index.html">Storage</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/processing/index.html">Processing</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="../concepts/glossary.html">Glossary</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="index.html">Servers</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="2">
+ <button class="nav-item-toggle"></button>
+ <a class="nav-link" href="demo.html">Demo</a>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="5-minute-demo.html">Short Demo</a>
+ </li>
+ <li class="nav-item" data-depth="3">
+ <a class="nav-link" href="15-minute-demo.html">Long Demo</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="local.html">Local</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="redundant.html">Redundant</a>
+ </li>
+ <li class="nav-item" data-depth="2">
+ <a class="nav-link" href="distributed.html">Distributed</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../customization/index.html">Customization</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development/index.html">Developer Guide</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../community/index.html">Community</a>
+ </li>
+</ul>
+ </li>
+</ul>
+ </nav>
+</div>
+<div class="nav-panel-explore" data-panel="explore">
+ <div class="context">
+ <span class="title">Apache James Reference Book</span>
+ <span class="version">3.5 Alpha</span>
+ </div>
+ <ul class="components">
+ <li class="component is-current">
+ <span class="title">Apache James Reference Book</span>
+ <ul class="versions">
+ <li class="version is-current is-latest">
+ <a href="../index.html">3.5 Alpha</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+</div>
+ </div>
+ </aside>
+</div>
+<main class="article">
+<div class="toolbar" role="navigation">
+<button class="nav-toggle"></button>
+ <a href="../index.html" class="home-link"></a>
+<nav class="breadcrumbs" aria-label="breadcrumbs">
+ <ul>
+ <li><a href="../index.html">Apache James Reference Book</a></li>
+ <li><a href="run.html">Run James in Production</a></li>
+ </ul>
+</nav>
+</div>
+ <div class="content">
+<article class="doc">
+<h1 class="page">Run James in Production</h1>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>James provides a number of <strong>profiles</strong> out of the box.
+These profiles have been tested and verified so you can
+get set up quickly with a production mail server that you
+can use with confidence.</p>
+</div>
+<div class="paragraph">
+<p>The available profiles are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="#minimal">James Minimal Profile</a></p>
+</li>
+<li>
+<p><a href="#basic">James Basic Profile</a></p>
+</li>
+<li>
+<p><a href="#advanced">James Advanced Profile</a></p>
+</li>
+<li>
+<p><a href="#distributed">James Distributed Profile</a></p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="minimal"><a class="anchor" href="#minimal"></a>James Minimal Profile</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you are not sure which profile you should be using, then
+you probably ought to be using the <strong>James Minimal Profile</strong>.</p>
+</div>
+<div class="paragraph">
+<p>This profile is intended to be the simplest to set up and use in production.
+It has the least amount of dependencies and complexities. If you do not yet
+have a huge amount of emails to process, then usually the simplicity is
+well worth the loss of some functionality. The last thing you need is
+to have to resolve difficult issues on a production server when you have not
+yet acquired the requisite knowledge to deal with those issues. Using the
+<strong>James Minimal Profile</strong> will help you reduce the risk of running into
+production issues.</p>
+</div>
+<div class="paragraph">
+<p>This profile is:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Suggested for use with smaller deployments</p>
+</li>
+<li>
+<p>Appropriate for use by most operators</p>
+</li>
+<li>
+<p>The preferred choice for most installations</p>
+</li>
+<li>
+<p>Endowed with fewer dependencies, which makes it simpler and less risky to use in production</p>
+</li>
+<li>
+<p>Only dependent on your local file system for data storage, so very easy to manage</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>(TODO: Add link to details page)</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="basic"><a class="anchor" href="#basic"></a>James Basic Profile</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>This profile is intended to be relatively easy to use, but provides additional features with regards
+to data storage and management. Of course, these additional features come at the cost of more
+operational complexity. You will have to now deal with a relational database and all the fun
+that comes with it. However, if you are already an expert at relational database management,
+then this profile should be a natural choice for you.</p>
+</div>
+<div class="paragraph">
+<p>This profile is:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Suggested for smaller deployments that require data persisted in a relational database</p>
+</li>
+<li>
+<p>Appropriate for most operators provided that you understand relational databases and data indexing</p>
+</li>
+<li>
+<p>Less complex than most profiles, but also less performant</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>(TODO: Add link to details page)</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="advanced"><a class="anchor" href="#advanced"></a>James Advanced Profile</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>When your requirements start to get a little more serious
+(let’s say in the tens of millions of emails), then you may want to
+start to consider using the <strong>James Advanced Profile</strong>.</p>
+</div>
+<div class="paragraph">
+<p>This profile is:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Intended for use by experienced operators only</p>
+</li>
+<li>
+<p>Used for mid-sized to large deployments</p>
+</li>
+<li>
+<p>More performant than the Minimal and Basic Profiles, but also more complex</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>(TODO: Add link to details page)</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="distributed"><a class="anchor" href="#distributed"></a>James Distributed Profile</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The <strong>James Distributed Profile</strong> is a heavy-duty industrial enterprise mail server.</p>
+</div>
+<div class="paragraph">
+<p>This profile is:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Intended for use by experts only</p>
+</li>
+<li>
+<p>Use for large-scale distributed deployments</p>
+</li>
+<li>
+<p>The most feature-rich profile, but also by far the most complex</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>(TODO: Add link to details page)</p>
+</div>
+</div>
+</div>
+</article>
+<aside class="toc sidebar" data-title="Contents" data-levels="2">
+ <div class="toc-menu"></div>
+</aside>
+ </div>
+</main>
+</div>
+<footer class="footer">
+ <p>This page was built using the Antora default UI.</p>
+ <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
+</footer>
+<script src="../../../_/js/site.js"></script>
+<script async src="../../../_/js/vendor/highlight.js"></script>
+ </body>
+</html>
diff --git a/sitemap.xml b/sitemap.xml
new file mode 100644
index 0000000..585cb06
--- /dev/null
+++ b/sitemap.xml
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+<url>
+<loc>https://james.apache.org/main/3.5/community/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/glossary.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/mail/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/messages/imf.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/messages/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/messages/mime.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/processing/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/protocols/esmtp.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/protocols/imap.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/protocols/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/protocols/jmap.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/protocols/lmtp.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/protocols/pop.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/protocols/smtp.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/storage/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/concepts/user/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/customization/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/development/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/development/logging.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/15-minute-demo.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/5-minute-demo.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/demo.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/distributed.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/index.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/local.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/redundant.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+<url>
+<loc>https://james.apache.org/main/3.5/servers/run.html</loc>
+<lastmod>2020-07-07T12:52:52.144Z</lastmod>
+</url>
+</urlset>