]> git.proxmox.com Git - pmg-docs.git/blame - pmgproxy.adoc
add SSL ceriticate generation doc
[pmg-docs.git] / pmgproxy.adoc
CommitLineData
fa49ddc5
DM
1ifdef::manvolnum[]
2pmgproxy(8)
3===========
4:pmg-toplevel:
5
6NAME
7----
8
9pmgproxy - Proxmox Mail Gateway API Proxy Daemon
10
11
12SYNOPSIS
13--------
14
15include::pmgproxy.8-synopsis.adoc[]
16
17DESCRIPTION
18-----------
19endif::manvolnum[]
20
21ifndef::manvolnum[]
22pmgproxy - Proxmox Mail Gateway API Proxy Daemon
23================================================
24endif::manvolnum[]
25
26This daemon exposes the whole {pmg} API on TCP port 8006 using
27HTTPS. It runs as user `www-data` and has very limited permissions.
28Operation requiring more permissions are forwarded to the local
29`pmgdaemon`.
30
31Requests targeted for other nodes are automatically forwarded to those
32nodes. This means that you can manage your whole cluster by connecting
33to a single {pmg} node.
34
35Alternative HTTPS certificate
36-----------------------------
37
38By default, pmgproxy uses the certificate `/etc/pmg/pmg-api.pem` for
39HTTPS connections. This certificate is a self signed certificate, and
40therefor not trusted by browsers and operating systems by default. You
41can simply replace this certificate with your own (please include the key
42inside the '.pem' file).
43
44
45ifdef::manvolnum[]
46include::pmg-copyright.adoc[]
47endif::manvolnum[]