X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=pvenode.adoc;h=a41085fd521bd9362c49f3c45b0e463362b2452d;hb=c8311c1eddadeb83d95d5fb29b14637d33801663;hp=dce428ffbfb051e39a13cbf918f5e0154303042b;hpb=9cbe129fb2975a3a2a3f1a6d474ed113f56357bf;p=pve-docs.git diff --git a/pvenode.adoc b/pvenode.adoc index dce428f..a41085f 100644 --- a/pvenode.adoc +++ b/pvenode.adoc @@ -23,14 +23,32 @@ Proxmox Node Management :pve-toplevel: endif::manvolnum[] -The {PVE} node management tools (`pvenode`) allows to control node specific +The {PVE} node management tool (`pvenode`) allows to control node specific settings and resources. -Currently the `pvenode` tool allows to manage the node's SSL certificates used -for API and the web GUI. It includes an implementation of the **A**utomatic -**C**ertificate **M**anagement **E**nvironment (ACME) protocol, allowing {pve} -admins to interface with Let's Encrypt, with which trusted certificates can be -generated and setup easily. +Currently `pvenode` allows to set a node's description and to manage +the node's SSL certificates used for the API and the web GUI through `pveproxy`. + +ifdef::manvolnum[] +include::output-format.adoc[] +endif::manvolnum[] + +EXAMPLES +-------- +`pvenode cert set certificate.crt certificate.key -force` + +Install an externally provided certificate. Both files need to be PEM encoded. +`certificate.key` contains the private key and `certificate.crt` contains the +whole certificate chain. + +----- +pvenode acme account register default mail@example.invalid +pvenode config set --acme domains=example.invalid +pvenode acme cert order +systemctl restart pveproxy +----- + +Setup ACME account and order a certificate for local node. // TODO: extend and improve chapter!