Documentation Revamp

Co-authored-by: jbdoumenjou <jb.doumenjou@gmail.com>

docs/content/reference/acme.md

@@ -0,0 +1,173 @@
+# ACME - Reference
+
+Every Options for ACME
+{: .subtitle} 
+
+## TOML
+
+```toml
+    # Sample entrypoint configuration when using ACME.
+    [entryPoints]
+      [entryPoints.http]
+      address = ":80"
+      [entryPoints.https]
+      address = ":443"
+        [entryPoints.https.tls]
+        
+    # Enable ACME (Let's Encrypt): automatic SSL.
+    [acme]
+    
+    # Email address used for registration.
+    #
+    # Required
+    #
+    email = "test@traefik.io"
+    
+    # File used for certificates storage.
+    #
+    # Optional (Deprecated)
+    #
+    #storageFile = "acme.json"
+    
+    # File or key used for certificates storage.
+    #
+    # Required
+    #
+    storage = "acme.json"
+    # or `storage = "traefik/acme/account"` if using KV store.
+    
+    # Entrypoint to proxy acme apply certificates to.
+    #
+    # Required
+    #
+    entryPoint = "https"
+    
+    # Deprecated, replaced by [acme.dnsChallenge].
+    #
+    # Optional.
+    #
+    # dnsProvider = "digitalocean"
+    
+    # Deprecated, replaced by [acme.dnsChallenge.delayBeforeCheck].
+    #
+    # Optional
+    # Default: 0
+    #
+    # delayDontCheckDNS = 0
+    
+    # If true, display debug log messages from the acme client library.
+    #
+    # Optional
+    # Default: false
+    #
+    # acmeLogging = true
+    
+    # If true, override certificates in key-value store when using storeconfig.
+    #
+    # Optional
+    # Default: false
+    #
+    # overrideCertificates = true
+    
+    # Deprecated. Enable on demand certificate generation.
+    #
+    # Optional
+    # Default: false
+    #
+    # onDemand = true
+    
+    # Enable certificate generation on frontends host rules.
+    #
+    # Optional
+    # Default: false
+    #
+    # onHostRule = true
+    
+    # CA server to use.
+    # Uncomment the line to use Let's Encrypt's staging server,
+    # leave commented to go to prod.
+    #
+    # Optional
+    # Default: "https://acme-v02.api.letsencrypt.org/directory"
+    #
+    # caServer = "https://acme-staging-v02.api.letsencrypt.org/directory"
+    
+    # KeyType to use.
+    #
+    # Optional
+    # Default: "RSA4096"
+    #
+    # Available values : "EC256", "EC384", "RSA2048", "RSA4096", "RSA8192"
+    #
+    # KeyType = "RSA4096"
+    
+    # Use a TLS-ALPN-01 ACME challenge.
+    #
+    # Optional (but recommended)
+    #
+    [acme.tlsChallenge]
+    
+    # Use a HTTP-01 ACME challenge.
+    #
+    # Optional
+    #
+    # [acme.httpChallenge]
+    
+      # EntryPoint to use for the HTTP-01 challenges.
+      #
+      # Required
+      #
+      # entryPoint = "http"
+    
+    # Use a DNS-01 ACME challenge rather than HTTP-01 challenge.
+    # Note: mandatory for wildcard certificate generation.
+    #
+    # Optional
+    #
+    # [acme.dnsChallenge]
+    
+      # DNS provider used.
+      #
+      # Required
+      #
+      # provider = "digitalocean"
+    
+      # By default, the provider will verify the TXT DNS challenge record before letting ACME verify.
+      # If delayBeforeCheck is greater than zero, this check is delayed for the configured duration in seconds.
+      # Useful if internal networks block external DNS queries.
+      #
+      # Optional
+      # Default: 0
+      #
+      # delayBeforeCheck = 0
+    
+      # Use following DNS servers to resolve the FQDN authority.
+      #
+      # Optional
+      # Default: empty
+      #
+      # resolvers = ["1.1.1.1:53", "8.8.8.8:53"]
+    
+      # Disable the DNS propagation checks before notifying ACME that the DNS challenge is ready.
+      #
+      # NOT RECOMMENDED:
+      # Increase the risk of reaching Let's Encrypt's rate limits.
+      #
+      # Optional
+      # Default: false
+      #
+      # disablePropagationCheck = true
+    
+    # Domains list.
+    # Only domains defined here can generate wildcard certificates.
+    # The certificates for these domains are negotiated at traefik startup only.
+    #
+    # [[acme.domains]]
+    #   main = "local1.com"
+    #   sans = ["test1.local1.com", "test2.local1.com"]
+    # [[acme.domains]]
+    #   main = "local2.com"
+    # [[acme.domains]]
+    #   main = "*.local3.com"
+    #   sans = ["local3.com", "test1.test1.local3.com"]
+```