diff --git a/docs/service-mesh/ca/README.md b/docs/service-mesh/ca/README.md
index 2a3d14d637..cd63244ee2 100644
--- a/docs/service-mesh/ca/README.md
+++ b/docs/service-mesh/ca/README.md
@@ -101,3 +101,14 @@ Periodic (or background) opeartions are started automatically by the Consul lead
 ####TODO:
 - sequence diagram for leaf signing 
 - sequence diagram for CA cert rotation
+
+## CAManager states
+
+This section is a work in progress
+
+TODO: style the diagram to match the others, and add some narative text to describe the
+diagram.
+
+![CA Mananger states](./state-machine.svg)
+
+
diff --git a/docs/service-mesh/ca/state-machine.mmd b/docs/service-mesh/ca/state-machine.mmd
new file mode 100644
index 0000000000..214e311679
--- /dev/null
+++ b/docs/service-mesh/ca/state-machine.mmd
@@ -0,0 +1,23 @@
+stateDiagram-v2
+
+    [*] --> Uninitialized
+    Uninitialized --> Initializing : InitializeCA
+    Uninitialized --> Reconfig : UpdateConfiguration
+    Reconfig --> Uninitialized : return
+
+    # Initialized can transition to any state
+    Initialized --> Renew : RenewIntermediate
+    Initialized --> Uninitialized : Stop
+    Initialized --> Reconfig  : UpdateConfiguration
+    Initialized --> Initializing : INVALID
+
+    # Initialized is set using validate=false
+    Uninitialized --> Initialized : INVALID
+    Reconfig --> Initialized : return
+    Initializing --> Initialized : InitializeCA complete
+    Renew --> Initialized : return
+
+    # Uninitialized is set using validate=false
+    Renew --> Uninitialized : Stop
+    Reconfig --> Uninitialized : Stop
+    Initializing --> Uninitialized : Stop
diff --git a/docs/service-mesh/ca/state-machine.svg b/docs/service-mesh/ca/state-machine.svg
new file mode 100644
index 0000000000..f63e880e08
--- /dev/null
+++ b/docs/service-mesh/ca/state-machine.svg
@@ -0,0 +1 @@
+<svg id="graph-div" width="884px" xmlns="http://www.w3.org/2000/svg" class="statediagram" height="458px" style="max-width: 1617.232421875px;" viewBox="0 0 924.1328125 458"><style>#graph-div{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#graph-div .error-icon{fill:#552222;}#graph-div .error-text{fill:#552222;stroke:#552222;}#graph-div .edge-thickness-normal{stroke-width:2px;}#graph-div .edge-thickness-thick{stroke-width:3.5px;}#graph-div .edge-pattern-solid{stroke-dasharray:0;}#graph-div .edge-pattern-dashed{stroke-dasharray:3;}#graph-div .edge-pattern-dotted{stroke-dasharray:2;}#graph-div .marker{fill:#333333;stroke:#333333;}#graph-div .marker.cross{stroke:#333333;}#graph-div svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#graph-div defs #statediagram-barbEnd{fill:#333333;stroke:#333333;}#graph-div g.stateGroup text{fill:#9370DB;stroke:none;font-size:10px;}#graph-div g.stateGroup text{fill:#333;stroke:none;font-size:10px;}#graph-div g.stateGroup .state-title{font-weight:bolder;fill:#131300;}#graph-div g.stateGroup rect{fill:#ECECFF;stroke:#9370DB;}#graph-div g.stateGroup line{stroke:#333333;stroke-width:1;}#graph-div .transition{stroke:#333333;stroke-width:1;fill:none;}#graph-div .stateGroup .composit{fill:white;border-bottom:1px;}#graph-div .stateGroup .alt-composit{fill:#e0e0e0;border-bottom:1px;}#graph-div .state-note{stroke:#aaaa33;fill:#fff5ad;}#graph-div .state-note text{fill:black;stroke:none;font-size:10px;}#graph-div .stateLabel .box{stroke:none;stroke-width:0;fill:#ECECFF;opacity:0.5;}#graph-div .edgeLabel .label rect{fill:#ECECFF;opacity:0.5;}#graph-div .edgeLabel .label text{fill:#333;}#graph-div .label div .edgeLabel{color:#333;}#graph-div .stateLabel text{fill:#131300;font-size:10px;font-weight:bold;}#graph-div .node circle.state-start{fill:#333333;stroke:#333333;}#graph-div .node .fork-join{fill:#333333;stroke:#333333;}#graph-div .node circle.state-end{fill:#9370DB;stroke:white;stroke-width:1.5;}#graph-div .end-state-inner{fill:white;stroke-width:1.5;}#graph-div .node rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#graph-div .node polygon{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#graph-div #statediagram-barbEnd{fill:#333333;}#graph-div .statediagram-cluster rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#graph-div .cluster-label,#graph-div .nodeLabel{color:#131300;}#graph-div .statediagram-cluster rect.outer{rx:5px;ry:5px;}#graph-div .statediagram-state .divider{stroke:#9370DB;}#graph-div .statediagram-state .title-state{rx:5px;ry:5px;}#graph-div .statediagram-cluster.statediagram-cluster .inner{fill:white;}#graph-div .statediagram-cluster.statediagram-cluster-alt .inner{fill:#f0f0f0;}#graph-div .statediagram-cluster .inner{rx:0;ry:0;}#graph-div .statediagram-state rect.basic{rx:5px;ry:5px;}#graph-div .statediagram-state rect.divider{stroke-dasharray:10,10;fill:#f0f0f0;}#graph-div .note-edge{stroke-dasharray:5;}#graph-div .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#graph-div .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#graph-div .statediagram-note text{fill:black;}#graph-div .statediagram-note .nodeLabel{color:black;}#graph-div .statediagram .edgeLabel{color:red;}#graph-div .statediagram .edgeLabel #dependencyStart,#graph-div .statediagram .edgeLabel #dependencyEnd{fill:#333333;stroke:#333333;stroke-width:1;}#graph-div .statediagram .edgeLabel .node rect,#graph-div .statediagram .edgeLabel .er.entityBox{fill:rgb(220,71,125);stroke-width:1;stroke:black;}#graph-div .statediagram .edgeLabel .node .label{color:white;}#graph-div .statediagram .edgeLabel .cluster rect{fill:#f0f0f0;stroke-width:1px;stroke:#333;}#graph-div .statediagram .edgeLabel .edgeLabel{background-color:#f0f0f0;}#graph-div .statediagram .edgeLabel .er.entityBox + .er.entityLabel{fill:white;}#graph-div .statediagram .edgeLabel .er.attributeBoxEven,#graph-div .statediagram .edgeLabel .er.attributeBoxOdd{fill:#fff;stroke:#777;}#graph-div .statediagram .edgeLabel:root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><defs><marker id="statediagram-barbEnd" refX="19" refY="7" markerWidth="20" markerHeight="14" markerUnits="strokeWidth" orient="auto"><path d="M 19,7 L9,13 L14,7 L9,1 Z"></path></marker></defs><g class="root"><g class="clusters"></g><g class="edgePaths"><path d="M475.73828125,22L475.73828125,26.166666666666668C475.73828125,30.333333333333332,475.73828125,38.666666666666664,475.73828125,47C475.73828125,55.333333333333336,475.73828125,63.666666666666664,475.73828125,67.83333333333333L475.73828125,72" id="edge6884" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M491.6817961836283,111L496.72376244469024,117.16666666666667C501.7657287057522,123.33333333333333,511.8496612278761,135.66666666666666,512.7036320058997,148C513.5576027839232,160.33333333333334,505.18161181784654,172.66666666666666,500.9936163348082,178.83333333333334L496.8056208517699,185" id="edge6885" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M528.64453125,99.66608863609686L580.8352864583334,107.72174053008071C633.0260416666666,115.77739242406456,737.4075520833334,131.88869621203227,789.5983072916666,149.3610147726828C841.7890625,166.83333333333334,841.7890625,185.66666666666666,841.7890625,204.5C841.7890625,223.33333333333334,841.7890625,242.16666666666666,841.7890625,261C841.7890625,279.8333333333333,841.7890625,298.6666666666667,841.7890625,317.5C841.7890625,336.3333333333333,841.7890625,355.1666666666667,816.6875,372.0996673843436C791.5859375,389.0326681020206,741.3828125,404.0653362040411,716.28125,411.5816702550514L691.1796875,419.0980043060616" id="edge6886" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M653.1015625,411L653.1015625,404.8333333333333C653.1015625,398.6666666666667,653.1015625,386.3333333333333,653.1015625,370.75C653.1015625,355.1666666666667,653.1015625,336.3333333333333,653.1015625,317.5C653.1015625,298.6666666666667,653.1015625,279.8333333333333,653.1015625,261C653.1015625,242.16666666666666,653.1015625,223.33333333333334,653.1015625,204.5C653.1015625,185.66666666666666,653.1015625,166.83333333333334,632.3587239583334,150.8089270638329C611.6158854166666,134.78452079433248,570.1302083333334,121.56904158866497,549.3873697916666,114.96130198583121L528.64453125,108.35356238299747" id="edge6887" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M391.8984375,327.044105096318L356.3958333333333,334.87008758026496C320.8932291666667,342.69607006421194,249.88802083333334,358.348035032106,200.76432291666666,373.00818915473764C151.640625,387.66834327736916,124.3984375,401.33668655473844,110.77734375,408.17085819342304L97.15625,415.00502983210765" id="edge6888" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M415.8004701327434,298L409.66705844395284,291.8333333333333C403.53364675516224,285.6666666666667,391.26682337758115,273.3333333333333,385.1334116887906,257.75C379,242.16666666666666,379,223.33333333333334,379,204.5C379,185.66666666666666,379,166.83333333333334,389.5584554756637,151.25C400.1169109513274,135.66666666666666,421.2338219026549,123.33333333333333,431.7922773783186,117.16666666666667L442.3507328539823,111" id="edge6889" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M478.4921875,325.3343424739792L523.3177083333334,333.44528539498265C568.1432291666666,341.5562283159861,657.7942708333334,357.77811415799306,692.3226862094394,372.0557237456632C726.8511015855457,386.3333333333333,706.2568906710916,398.6666666666667,695.9597852138644,404.8333333333333L685.6626797566372,411" id="edge6890" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M399.53878595132744,298L388.26279037610624,291.8333333333333C376.986794800885,285.6666666666667,354.4348036504425,273.3333333333333,360.91531849188794,260.5524465619366C367.3958333333333,247.77155979053995,402.9088541666667,234.54311958107994,420.6653645833333,227.9288994763499L438.421875,221.3146793716199" id="edge6891" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M520.69047289823,111L534.906123248525,117.16666666666667C549.12177359882,123.33333333333333,577.55307429941,135.66666666666666,591.768724649705,151.25C605.984375,166.83333333333334,605.984375,185.66666666666666,605.984375,204.5C605.984375,223.33333333333334,605.984375,242.16666666666666,584.7356770833334,258.6127731271824C563.4869791666666,275.0588795876981,520.9895833333334,289.1177591753961,499.7408854166667,296.1471989692451L478.4921875,303.1766387630941" id="edge6892" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M615.0234375,420.62688226014626L585.0520833333334,412.85573521678856C555.0807291666666,405.0845881734308,495.1380208333333,389.5422940867154,465.1666666666667,375.604480376691C435.1953125,361.6666666666667,435.1953125,349.3333333333333,435.1953125,343.1666666666667L435.1953125,337" id="edge6893" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M483.5625,224L483.5625,230.16666666666666C483.5625,236.33333333333334,483.5625,248.66666666666666,478.2834854351033,261C473.0044708702065,273.3333333333333,462.44644174041304,285.6666666666667,457.16742717551625,291.8333333333333L451.88841261061947,298" id="edge6894" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M66.2734375,411L66.2734375,404.8333333333333C66.2734375,398.6666666666667,66.2734375,386.3333333333333,120.54427083333333,371.85514520068335C174.81510416666666,357.3769570680333,283.3567708333333,340.7539141360665,337.6276041666667,332.44239267008317L391.8984375,324.1308712040998" id="edge6895" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M51.60529590707965,411L46.96665283923304,404.8333333333333C42.328009771386434,398.6666666666667,33.05072363569322,386.3333333333333,28.412080567846612,370.75C23.7734375,355.1666666666667,23.7734375,336.3333333333333,23.7734375,317.5C23.7734375,298.6666666666667,23.7734375,279.8333333333333,23.7734375,261C23.7734375,242.16666666666666,23.7734375,223.33333333333334,23.7734375,204.5C23.7734375,185.66666666666666,23.7734375,166.83333333333334,90.283203125,149.10229927774847C156.79296875,131.37126522216366,289.8125,114.7425304443273,356.322265625,106.42816305540912L422.83203125,98.11379566649093" id="edge6896" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M615.0234375,424.89895456209575L557.3515625,416.41579546841314C499.6796875,407.93263637473046,384.3359375,390.96631818736523,326.6640625,373.06649242701593C268.9921875,355.1666666666667,268.9921875,336.3333333333333,268.9921875,317.5C268.9921875,298.6666666666667,268.9921875,279.8333333333333,268.9921875,261C268.9921875,242.16666666666666,268.9921875,223.33333333333334,268.9921875,204.5C268.9921875,185.66666666666666,268.9921875,166.83333333333334,294.6321614583333,150.40972156618236C320.2721354166667,133.98610979903137,371.5520833333333,119.97221959806274,397.1920572916667,112.96527449757842L422.83203125,105.9583293970941" id="edge6897" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path><path d="M470.36252074115043,185L466.1881683259587,178.83333333333334C462.01381591076694,172.66666666666666,453.6651110803835,160.33333333333334,452.8111403023599,148C451.9571695243363,135.66666666666666,458.5979327986726,123.33333333333333,461.9183144358407,117.16666666666667L465.23869607300884,111" id="edge6898" class=" edge-thickness-normal transition" style="fill:none" marker-end="url(#statediagram-barbEnd)"></path></g><g class="edgeLabels"><g class="edgeLabel"><g class="label" transform="translate(0, 0)"><rect rx="0" ry="0" width="0" height="0"></rect><foreignObject width="0" height="0"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel"></span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(521.93359375, 148)"><g class="label" transform="translate(-40.84375, -12)"><rect rx="0" ry="0" width="81.6875" height="24"></rect><foreignObject width="81.6875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">InitializeCA</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(841.7890625, 261)"><g class="label" transform="translate(-74.34375, -12)"><rect rx="0" ry="0" width="148.6875" height="24"></rect><foreignObject width="148.6875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">UpdateConfiguration</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(653.1015625, 261)"><g class="label" transform="translate(-22.5, -12)"><rect rx="0" ry="0" width="45" height="24"></rect><foreignObject width="45" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">return</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(178.8828125, 374)"><g class="label" transform="translate(-70.109375, -12)"><rect rx="0" ry="0" width="140.21875" height="24"></rect><foreignObject width="140.21875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">RenewIntermediate</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(379, 204.5)"><g class="label" transform="translate(-15.7734375, -12)"><rect rx="0" ry="0" width="31.546875" height="24"></rect><foreignObject width="31.546875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">Stop</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(747.4453125, 374)"><g class="label" transform="translate(-74.34375, -12)"><rect rx="0" ry="0" width="148.6875" height="24"></rect><foreignObject width="148.6875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">UpdateConfiguration</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(331.8828125, 261)"><g class="label" transform="translate(-27.1171875, -12)"><rect rx="0" ry="0" width="54.234375" height="24"></rect><foreignObject width="54.234375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">INVALID</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(605.984375, 204.5)"><g class="label" transform="translate(-27.1171875, -12)"><rect rx="0" ry="0" width="54.234375" height="24"></rect><foreignObject width="54.234375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">INVALID</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(435.1953125, 374)"><g class="label" transform="translate(-22.5, -12)"><rect rx="0" ry="0" width="45" height="24"></rect><foreignObject width="45" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">return</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(483.5625, 261)"><g class="label" transform="translate(-76.859375, -12)"><rect rx="0" ry="0" width="153.71875" height="24"></rect><foreignObject width="153.71875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">InitializeCA complete</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(66.2734375, 374)"><g class="label" transform="translate(-22.5, -12)"><rect rx="0" ry="0" width="45" height="24"></rect><foreignObject width="45" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">return</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(23.7734375, 261)"><g class="label" transform="translate(-15.7734375, -12)"><rect rx="0" ry="0" width="31.546875" height="24"></rect><foreignObject width="31.546875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">Stop</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(268.9921875, 261)"><g class="label" transform="translate(-15.7734375, -12)"><rect rx="0" ry="0" width="31.546875" height="24"></rect><foreignObject width="31.546875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">Stop</span></div></foreignObject></g></g><g class="edgeLabel" transform="translate(445.31640625, 148)"><g class="label" transform="translate(-15.7734375, -12)"><rect rx="0" ry="0" width="31.546875" height="24"></rect><foreignObject width="31.546875" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="edgeLabel">Stop</span></div></foreignObject></g></g></g><g class="nodes"><g class="node default" id="state-root_start-6884" transform="translate(475.73828125, 15)"><circle class="state-start" r="7" width="14" height="14"></circle></g><g class="node statediagram-state" id="state-Uninitialized-6898" transform="translate(475.73828125, 91.5)"><rect class="basic label-container" style="" x="-52.90625" y="-19.5" width="105.8125" height="39"></rect><g class="label" style="" transform="translate(-45.40625, -12)"><foreignObject width="90.8125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="nodeLabel">Uninitialized</span></div></foreignObject></g></g><g class="node statediagram-state" id="state-Initializing-6898" transform="translate(483.5625, 204.5)"><rect class="basic label-container" style="" x="-45.140625" y="-19.5" width="90.28125" height="39"></rect><g class="label" style="" transform="translate(-37.640625, -12)"><foreignObject width="75.28125" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="nodeLabel">Initializing</span></div></foreignObject></g></g><g class="node statediagram-state" id="state-Reconfig-6897" transform="translate(653.1015625, 430.5)"><rect class="basic label-container" style="" x="-38.078125" y="-19.5" width="76.15625" height="39"></rect><g class="label" style="" transform="translate(-30.578125, -12)"><foreignObject width="61.15625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="nodeLabel">Reconfig</span></div></foreignObject></g></g><g class="node statediagram-state" id="state-Initialized-6895" transform="translate(435.1953125, 317.5)"><rect class="basic label-container" style="" x="-43.296875" y="-19.5" width="86.59375" height="39"></rect><g class="label" style="" transform="translate(-35.796875, -12)"><foreignObject width="71.59375" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="nodeLabel">Initialized</span></div></foreignObject></g></g><g class="node statediagram-state" id="state-Renew-6896" transform="translate(66.2734375, 430.5)"><rect class="basic label-container" style="" x="-30.8828125" y="-19.5" width="61.765625" height="39"></rect><g class="label" style="" transform="translate(-23.3828125, -12)"><foreignObject width="46.765625" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: inline-block; white-space: nowrap;"><span class="nodeLabel">Renew</span></div></foreignObject></g></g></g></g></g></svg>
\ No newline at end of file