diff --git a/doc/file.README.html b/doc/file.README.html
index 22a8359..2446fa6 100644
--- a/doc/file.README.html
+++ b/doc/file.README.html
@@ -66,7 +66,7 @@
 
 <h2 id="label-Synopsis">Synopsis</h2>
 
-<p>This Puppet module configures settings for Puppet master and agents, PuppetDB and R10k, the full bundle. The syntax etc is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with External Node Classifiers (ENC), for instance Foreman.</p>
+<p>This Puppet module configures settings for Puppet master and agents, PuppetDB and R10k, the full bundle. The syntax is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with External Node Classifiers (ENC), for instance Foreman.</p>
 
 <h2 id="label-WARNING">WARNING</h2>
 
@@ -74,7 +74,9 @@
 
 <h2 id="label-Features">Features</h2>
 <ul><li>
-<p>install packages depending on whether the host fqdn equals either master fqdn, db fqdn or none (agent).</p>
+<p>if the host FQDN matches your specified Puppet master via <code>$pt_pm_fqdn</code>, it installs and configures a puppetmaster. On your puppetmaster, If you set <code>$pt_use_r10k</code>to <code>true</code>, it also installs r10k to connect to a control repo and manage the code available to clients via Puppetfile. If you set <code>$pt_use_r10k_webhook</code>to <code>true</code>, it also installs a simple webhook listener to watch for post_hooks from gitlab, and triggers the r10k deployment.</p>
+</li><li>
+<p>if the host FQDN matches your specified puppetdb host via <code>$pt_db_fqdn</code>, Puppetdb is installed and added to the puppetmaster config. Settings for the (external) postgreSQL database are also configured.</p>
 </li><li>
 <p>open firewall ports depending on fqdn choices</p>
 </li><li>
@@ -82,7 +84,7 @@
 </li><li>
 <p>manage directories</p>
 </li><li>
-<p>manage user settings (optional)</p>
+<p>manage puppet user settings (optional)</p>
 </li></ul>
 
 <h2 id="label-Support">Support</h2>
diff --git a/doc/index.html b/doc/index.html
index c7651e8..3b66c1d 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -66,7 +66,7 @@
 
 <h2 id="label-Synopsis">Synopsis</h2>
 
-<p>This Puppet module configures settings for Puppet master and agents, PuppetDB and R10k, the full bundle. The syntax etc is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with External Node Classifiers (ENC), for instance Foreman.</p>
+<p>This Puppet module configures settings for Puppet master and agents, PuppetDB and R10k, the full bundle. The syntax is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with External Node Classifiers (ENC), for instance Foreman.</p>
 
 <h2 id="label-WARNING">WARNING</h2>
 
@@ -74,7 +74,9 @@
 
 <h2 id="label-Features">Features</h2>
 <ul><li>
-<p>install packages depending on whether the host fqdn equals either master fqdn, db fqdn or none (agent).</p>
+<p>if the host FQDN matches your specified Puppet master via <code>$pt_pm_fqdn</code>, it installs and configures a puppetmaster. On your puppetmaster, If you set <code>$pt_use_r10k</code>to <code>true</code>, it also installs r10k to connect to a control repo and manage the code available to clients via Puppetfile. If you set <code>$pt_use_r10k_webhook</code>to <code>true</code>, it also installs a simple webhook listener to watch for post_hooks from gitlab, and triggers the r10k deployment.</p>
+</li><li>
+<p>if the host FQDN matches your specified puppetdb host via <code>$pt_db_fqdn</code>, Puppetdb is installed and added to the puppetmaster config. Settings for the (external) postgreSQL database are also configured.</p>
 </li><li>
 <p>open firewall ports depending on fqdn choices</p>
 </li><li>
@@ -82,7 +84,7 @@
 </li><li>
 <p>manage directories</p>
 </li><li>
-<p>manage user settings (optional)</p>
+<p>manage puppet user settings (optional)</p>
 </li></ul>
 
 <h2 id="label-Support">Support</h2>
diff --git a/doc/puppet_classes/puppet_cd_3A_3Apuppetdb_3A_3Aservice.html b/doc/puppet_classes/puppet_cd_3A_3Apuppetdb_3A_3Aservice.html
index 70af012..8cf440f 100644
--- a/doc/puppet_classes/puppet_cd_3A_3Apuppetdb_3A_3Aservice.html
+++ b/doc/puppet_classes/puppet_cd_3A_3Apuppetdb_3A_3Aservice.html
@@ -122,10 +122,10 @@
 class puppet_cd::puppetdb::service (
 
 ) inherits puppet_cd::params {
-  if ($fqdn == $pt_puppetdb_server) and ($pt_use_puppetdb == true) {
+  if ($fqdn == $pt_db_fqdn) and ($pt_use_puppetdb == true) {
     require puppet_cd::puppetdb::files
 
-    service { $pt_puppetdb:
+    service { $pt_db_service:
       ensure     =&gt; running,
       hasstatus  =&gt; true,
       hasrestart =&gt; true,
diff --git a/doc/puppet_classes/puppet_cd_3A_3Aserver_3A_3Aservice.html b/doc/puppet_classes/puppet_cd_3A_3Aserver_3A_3Aservice.html
index c7784be..6fa6039 100644
--- a/doc/puppet_classes/puppet_cd_3A_3Aserver_3A_3Aservice.html
+++ b/doc/puppet_classes/puppet_cd_3A_3Aserver_3A_3Aservice.html
@@ -137,19 +137,7 @@
 39
 40
 41
-42
-43
-44
-45
-46
-47
-48
-49
-50
-51
-52
-53
-54</pre>
+42</pre>
       </td>
       <td>
         <pre class="code"><span class="info file"># File 'manifests/server/service.pp', line 6</span>
@@ -180,18 +168,6 @@ class puppet_cd::server::service (
     }
   }
 
-  # manage puppetdb service
-  if $fqdn == $pt_db_fqdn {
-    require puppet_cd::firewall::iptables
-
-    service { $pt_db_service:
-      ensure     =&gt; running,
-      hasstatus  =&gt; true,
-      hasrestart =&gt; true,
-      enable     =&gt; true,
-    }
-  }
-
   # manage webhook service
   if $pt_use_r10k_webhook == true {
     require puppet_cd::r10k::install