Add Pangolin certification dumping and minor cleanup (#963)

Author: Root-Core

docs/post_installation/reverse-proxy/r_p-pangolin.de.md

@@ -8,10 +8,13 @@ Die deklarative Konfiguration von Pangolin ist mittels sogenannter Blueprints se
 
 In diesem Beispiel wird die Zertifikatserstellung durch Pangolin übernommen. Das SSO von Pangolin ist aktiv und bieter zusätzlichen Schutz. Autodiscover, Autoconfig und MTA-STS, sowie die API für den Status sind öffentlich zugänglich.
 
+## Blueprint für Pangolin
+
 Es wird angenommen, dass mailcow auf Port 4443 über TLS erreichbar ist.
 Die Domain `example.com` ist entsprechend zu ersetzern.
+Entsprechende Zeilen sind unten markiert.
 
-```yaml
+```yaml hl_lines="5 12 21 28 37 44 53 60 69 76"
 public-resources:
   mailcow:
     auth:
@@ -94,13 +97,21 @@ public-resources:
         value: /.well-known/openpgpkey/*
 ```
 
+## In lokale Pangolin Instanz integrieren
+
+Wenn Pangolin und mailcow auf dem selben Server laufen, kann der Blueprint über das Webinterface hinzugfügt werden.
+
+> Organisation > Blaupausen > Blueprint hinzufügen
+
+## In remote Pangolin Instanz integrieren
+
 Die Einbindung in eine bestehende Pangolin-Instanz ist dank newt schnell erledigt:
 
 > Standorte > Standort hinzufügen > Newt Standort > Docker
 
 Die Umgebungsvariable `BLUEPRINT_FILE` wird hinzugefügt, exemplarisch liegt obrige Konfigurationsdatei unter `/opt/blueprint_mailcow.yml`.
 
-```yaml
+```yaml hl_lines="10"
 services:
   newt:
     image: fosrl/newt
@@ -112,3 +123,32 @@ services:
       - NEWT_SECRET=<YOUR_SECRET>
       - BLUEPRINT_FILE=/opt/blueprint_mailcow.yml
 ```
+
+## Zertifikate exportieren
+
+Da Pangolin zukünftig die Zertifikate erneuert, müssen diese auch für mailcow aktualisiert werden.
+
+Pangolins Compose Konfiguration wie folgt erweitern und markierte Zeilen anpassen:
+
+```yaml hl_lines="7 13 20"
+services:
+
+  [...]
+
+  traefik_certdumper:
+    command:
+      - --restart-containers=mailcowdockerized-postfix-mailcow-1,mailcowdockerized-dovecot-mailcow-1,mailcowdockerized-nginx-mailcow-1
+    container_name: traefik_certdumper
+    depends_on:
+      traefik:
+        condition: service_started
+    environment:
+      - DOMAIN=*.example.com
+    image: ghcr.io/kereis/traefik-certs-dumper:latest
+    network_mode: none
+    restart: unless-stopped
+    volumes:
+      - /run/docker.sock:/var/run/docker.sock:ro
+      - ./config/letsencrypt:/traefik:ro
+      - /opt/mailcow-dockerized/data/assets/ssl:/output:rw
+```

docs/post_installation/reverse-proxy/r_p-pangolin.en.md

@@ -8,10 +8,13 @@ Pangolin's declarative configuration is very simple using so-called Blueprints.
 
 In this example, certificate creation is handled by Pangolin. Pangolin's SSO is active and provides additional protection. Autodiscover, Autoconfig, and MTA-STS, as well as the API for status, are publicly accessible.
 
+## Blueprint for Pangolin
+
 It is assumed that mailcow is accessible on port 4443 via TLS.
 The domain `example.com` should be replaced accordingly.
+Relevant lines are marked below.
 
-```yaml
+```yaml hl_lines="5 12 21 28 37 44 53 60 69 76"
 public-resources:
   mailcow:
     auth:
@@ -94,13 +97,21 @@ public-resources:
         value: /.well-known/openpgpkey/*
 ```
 
-Integration into an existing Pangolin instance is quick and easy with newt:
+## Integrate into local Pangolin instance
+
+If Pangolin and mailcow are running on the same server, you can just add the blueprint via the web interface.
+
+> Organization > Blueprints > Add Blueprint
+
+## Integrate into remote Pangolin instance
+
+Integration into an existing remote Pangolin instance is quick and easy with newt:
 
 > Sites > Create Sites > Newt Site > Docker
 
 The environment variable `BLUEPRINT_FILE` is added. As an example, the configuration file above is located at `/opt/blueprint_mailcow.yml`.
 
-```yaml
+```yaml hl_lines="10"
 services:
   newt:
     image: fosrl/newt
@@ -112,3 +123,32 @@ services:
       - NEWT_SECRET=<YOUR_SECRET>
       - BLUEPRINT_FILE=/opt/blueprint_mailcow.yml
 ```
+
+## Export certificates
+
+As Pangolin will now renew the certificates, you need to update them for mailcow.
+
+Add this to Pangolin's compose configuration, modify the marked lines:
+
+```yaml hl_lines="7 13 20"
+services:
+
+  [...]
+
+  traefik_certdumper:
+    command:
+      - --restart-containers=mailcowdockerized-postfix-mailcow-1,mailcowdockerized-dovecot-mailcow-1,mailcowdockerized-nginx-mailcow-1
+    container_name: traefik_certdumper
+    depends_on:
+      traefik:
+        condition: service_started
+    environment:
+      - DOMAIN=*.example.com
+    image: ghcr.io/kereis/traefik-certs-dumper:latest
+    network_mode: none
+    restart: unless-stopped
+    volumes:
+      - /run/docker.sock:/var/run/docker.sock:ro
+      - ./config/letsencrypt:/traefik:ro
+      - /opt/mailcow-dockerized/data/assets/ssl:/output:rw
+```