selfhostde.toml 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. Name = "SelfHost.(de|eu)"
  2. Description = ''''''
  3. URL = "https://www.selfhost.de"
  4. Code = "selfhostde"
  5. Since = "v4.19.0"
  6. Example = '''
  7. SELFHOSTDE_USERNAME=xxx \
  8. SELFHOSTDE_PASSWORD=yyy \
  9. SELFHOSTDE_RECORDS_MAPPING=my.example.com:123 \
  10. lego --email you@example.com --dns selfhostde -d '*.example.com' -d example.com run
  11. '''
  12. Additional = """
  13. SelfHost.de doesn't have an API to create or delete TXT records,
  14. there is only an "unofficial" and undocumented endpoint to update an existing TXT record.
  15. So, before using lego to request a certificate for a given domain or wildcard (such as `my.example.org` or `*.my.example.org`),
  16. you must create:
  17. - one TXT record named `_acme-challenge.my.example.org` if you are **not** using wildcard for this domain.
  18. - two TXT records named `_acme-challenge.my.example.org` if you are using wildcard for this domain.
  19. After that you must edit the TXT record(s) to get the ID(s).
  20. You then must prepare the `SELFHOSTDE_RECORDS_MAPPING` environment variable with the following format:
  21. ```
  22. <domain_A>:<record_id_A1>:<record_id_A2>,<domain_B>:<record_id_B1>:<record_id_B2>,<domain_C>:<record_id_C1>:<record_id_C2>
  23. ```
  24. where each group of domain + record ID(s) is separated with a comma (`,`),
  25. and the domain and record ID(s) are separated with a colon (`:`).
  26. For example, if you want to create or renew a certificate for `my.example.org`, `*.my.example.org`, and `other.example.org`,
  27. you would need:
  28. - two separate records for `_acme-challenge.my.example.org`
  29. - and another separate record for `_acme-challenge.other.example.org`
  30. The resulting environment variable would then be: `SELFHOSTDE_RECORDS_MAPPING=my.example.com:123:456,other.example.com:789`
  31. """
  32. [Configuration]
  33. [Configuration.Credentials]
  34. SELFHOSTDE_USERNAME = "Username"
  35. SELFHOSTDE_PASSWORD = "Password"
  36. SELFHOSTDE_RECORDS_MAPPING = "Record IDs mapping with domains (ex: example.com:123:456,example.org:789,foo.example.com:147)"
  37. [Configuration.Additional]
  38. SELFHOSTDE_POLLING_INTERVAL = "Time between DNS propagation check in seconds (Default: 30)"
  39. SELFHOSTDE_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation in seconds (Default: 240)"
  40. SELFHOSTDE_TTL = "The TTL of the TXT record used for the DNS challenge in seconds (Default: 120)"
  41. SELFHOSTDE_HTTP_TIMEOUT = "API request timeout in seconds (Default: 30)"