]> git.proxmox.com Git - pmg-docs.git/blobdiff - pmgconfig.1-synopsis.adoc
installation: fix codeblock rendering in zfs performance tips section
[pmg-docs.git] / pmgconfig.1-synopsis.adoc
index 3073408e2486949f096a24dd10222f707a0b3d5a..a6712d79361cf2f96f74581794d950bf4300a581 100644 (file)
@@ -1,5 +1,182 @@
 *pmgconfig* `<COMMAND> [ARGS] [OPTIONS]`
 
+*pmgconfig acme account deactivate* `[<name>]` `[OPTIONS]`
+
+Deactivate existing ACME account at CA.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Delete account data even if the server refuses to deactivate the account.
+
+*pmgconfig acme account info* `[<name>]` `[FORMAT_OPTIONS]`
+
+Return existing ACME account information.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+*pmgconfig acme account list*
+
+ACME account index.
+
+*pmgconfig acme account register* `[<name>] {<contact>}` `[OPTIONS]`
+
+Register a new ACME account with a compatible CA.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+`<contact>`: `<string>` ::
+
+Contact email addresses.
+
+`--directory` `^https?://.*` ::
+
+URL of ACME CA directory endpoint.
+
+*pmgconfig acme account update* `[<name>]` `[OPTIONS]`
+
+Update existing ACME account information with CA. Note: not specifying any
+new account information triggers a refresh.
+
+`<name>`: `<name>` ('default =' `default`)::
+
+ACME account config file name.
+
+`--contact` `<string>` ::
+
+Contact email addresses.
+
+*pmgconfig acme cert order* `<type>` `[OPTIONS]`
+
+Order a new certificate from ACME-compatible CA.
+
+`<type>`: `<api | smtp>` ::
+
+The TLS certificate type (API or SMTP certificate).
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Overwrite existing custom certificate.
+
+*pmgconfig acme cert renew* `<type>` `[OPTIONS]`
+
+Renew existing certificate from CA.
+
+`<type>`: `<api | smtp>` ::
+
+The TLS certificate type (API or SMTP certificate).
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Force renewal even if expiry is more than 30 days away.
+
+*pmgconfig acme cert revoke* `<type>`
+
+Revoke existing certificate from CA.
+
+`<type>`: `<api | smtp>` ::
+
+The TLS certificate type (API or SMTP certificate).
+
+*pmgconfig acme plugin add* `<type> <id>` `[OPTIONS]`
+
+Add ACME plugin configuration.
+
+`<type>`: `<dns | standalone>` ::
+
+ACME challenge type.
+
+`<id>`: `<string>` ::
+
+ACME Plugin ID name
+
+`--api` `<1984hosting | acmedns | acmeproxy | active24 | ad | ali | anx | artfiles | arvan | aurora | autodns | aws | azion | azure | bookmyname | bunny | cf | clouddns | cloudns | cn | conoha | constellix | cpanel | curanet | cyon | da | ddnss | desec | df | dgon | dnsexit | dnshome | dnsimple | dnsservices | do | doapi | domeneshop | dp | dpi | dreamhost | duckdns | durabledns | dyn | dynu | dynv6 | easydns | edgedns | euserv | exoscale | fornex | freedns | gandi_livedns | gcloud | gcore | gd | geoscaling | googledomains | he | hetzner | hexonet | hostingde | huaweicloud | infoblox | infomaniak | internetbs | inwx | ionos | ipv64 | ispconfig | jd | joker | kappernet | kas | kinghost | knot | la | leaseweb | lexicon | linode | linode_v4 | loopia | lua | maradns | me | miab | misaka | myapi | mydevil | mydnsjp | mythic_beasts | namecheap | namecom | namesilo | nanelo | nederhost | neodigit | netcup | netlify | nic | njalla | nm | nsd | nsone | nsupdate | nw | oci | one | online | openprovider | openstack | opnsense | ovh | pdns | pleskxml | pointhq | porkbun | rackcorp | rackspace | rage4 | rcode0 | regru | scaleway | schlundtech | selectel | selfhost | servercow | simply | tele3 | tencent | transip | udr | ultra | unoeuro | variomedia | veesp | vercel | vscale | vultr | websupport | world4you | yandex | yc | zilore | zone | zonomi>` ::
+
+API plugin name
+
+`--data` `File with one key-value pair per line, will be base64url encode for storage in plugin config.` ::
+
+DNS plugin data. (base64 encoded)
+
+`--disable` `<boolean>` ::
+
+Flag to disable the config.
+
+`--nodes` `<string>` ::
+
+List of cluster node names.
+
+`--validation-delay` `<integer> (0 - 172800)` ('default =' `30`)::
+
+Extra delay in seconds to wait before requesting validation. Allows to cope with a long TTL of DNS records.
+
+*pmgconfig acme plugin config* `<id>` `[FORMAT_OPTIONS]`
+
+Get ACME plugin configuration.
+
+`<id>`: `<string>` ::
+
+Unique identifier for ACME plugin instance.
+
+*pmgconfig acme plugin list* `[OPTIONS]` `[FORMAT_OPTIONS]`
+
+ACME plugin index.
+
+`--type` `<dns | standalone>` ::
+
+Only list ACME plugins of a specific type
+
+*pmgconfig acme plugin remove* `<id>`
+
+Delete ACME plugin configuration.
+
+`<id>`: `<string>` ::
+
+Unique identifier for ACME plugin instance.
+
+*pmgconfig acme plugin set* `<id>` `[OPTIONS]`
+
+Update ACME plugin configuration.
+
+`<id>`: `<string>` ::
+
+ACME Plugin ID name
+
+`--api` `<1984hosting | acmedns | acmeproxy | active24 | ad | ali | anx | artfiles | arvan | aurora | autodns | aws | azion | azure | bookmyname | bunny | cf | clouddns | cloudns | cn | conoha | constellix | cpanel | curanet | cyon | da | ddnss | desec | df | dgon | dnsexit | dnshome | dnsimple | dnsservices | do | doapi | domeneshop | dp | dpi | dreamhost | duckdns | durabledns | dyn | dynu | dynv6 | easydns | edgedns | euserv | exoscale | fornex | freedns | gandi_livedns | gcloud | gcore | gd | geoscaling | googledomains | he | hetzner | hexonet | hostingde | huaweicloud | infoblox | infomaniak | internetbs | inwx | ionos | ipv64 | ispconfig | jd | joker | kappernet | kas | kinghost | knot | la | leaseweb | lexicon | linode | linode_v4 | loopia | lua | maradns | me | miab | misaka | myapi | mydevil | mydnsjp | mythic_beasts | namecheap | namecom | namesilo | nanelo | nederhost | neodigit | netcup | netlify | nic | njalla | nm | nsd | nsone | nsupdate | nw | oci | one | online | openprovider | openstack | opnsense | ovh | pdns | pleskxml | pointhq | porkbun | rackcorp | rackspace | rage4 | rcode0 | regru | scaleway | schlundtech | selectel | selfhost | servercow | simply | tele3 | tencent | transip | udr | ultra | unoeuro | variomedia | veesp | vercel | vscale | vultr | websupport | world4you | yandex | yc | zilore | zone | zonomi>` ::
+
+API plugin name
+
+`--data` `File with one key-value pair per line, will be base64url encode for storage in plugin config.` ::
+
+DNS plugin data. (base64 encoded)
+
+`--delete` `<string>` ::
+
+A list of settings you want to delete.
+
+`--digest` `<string>` ::
+
+Prevent changes if current configuration file has a different digest. This can be used to prevent concurrent modifications.
+
+`--disable` `<boolean>` ::
+
+Flag to disable the config.
+
+`--nodes` `<string>` ::
+
+List of cluster node names.
+
+`--validation-delay` `<integer> (0 - 172800)` ('default =' `30`)::
+
+Extra delay in seconds to wait before requesting validation. Allows to cope with a long TTL of DNS records.
+
 *pmgconfig apicert* `[OPTIONS]`
 
 Generate /etc/pmg/pmg-api.pem (self signed certificate for GUI and REST
@@ -9,6 +186,46 @@ API).
 
 Overwrite existing certificate.
 
+*pmgconfig cert delete* `<type> [<restart>]`
+
+DELETE custom certificate chain and key.
+
+`<type>`: `<api | smtp>` ::
+
+The TLS certificate type (API or SMTP certificate).
+
+`<restart>`: `<boolean>` ('default =' `0`)::
+
+Restart pmgproxy.
+
+*pmgconfig cert info* `[FORMAT_OPTIONS]`
+
+Get information about the node's certificates.
+
+*pmgconfig cert set* `<type> <certificates> <key>` `[OPTIONS]` `[FORMAT_OPTIONS]`
+
+Upload or update custom certificate chain and key.
+
+`<type>`: `<api | smtp>` ::
+
+The TLS certificate type (API or SMTP certificate).
+
+`<certificates>`: `<string>` ::
+
+PEM encoded certificate (chain).
+
+`<key>`: `<string>` ::
+
+PEM encoded private key.
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Overwrite existing custom or ACME certificate files.
+
+`--restart` `<boolean>` ('default =' `0`)::
+
+Restart services.
+
 *pmgconfig dkim_record*
 
 Get the public key for the configured selector, prepared as DKIM TXT record
@@ -52,11 +269,11 @@ Generate required files in /etc/pmg/
 
 *pmgconfig ldapsync*
 
-Syncronize the LDAP database.
+Synchronize the LDAP database.
 
 *pmgconfig sync* `[OPTIONS]`
 
-Syncronize Proxmox Mail Gateway configurations with system configuration.
+Synchronize Proxmox Mail Gateway configurations with system configuration.
 
 `--restart` `<boolean>` ('default =' `0`)::