Service Proxying

Valid for versions 92 through the latest version



Last modified: July 13, 2022


Service proxying configures local services to proxy requests for a cPanel account’s domains to a remote server. You can manage a cPanel account’s service proxying via API with the WHM API 1 set_service_proxy_backends and unset_all_service_proxy_backends functions.

You can configure the following services via service proxying:

  • Web Server (httpd)
  • Mailbox (Dovecot®)

For information about a specific service, read our cPanel service daemons documentation.

Service proxy configuration

All service proxy configurations assign a host as the general proxy backend server. In the absence of any other configurations, all compatible services proxy requests to that proxy backend server.

You can also configure different services to use different proxy backend servers. For example, you can configure the web server (httpd) to proxy requests to server, while Dovecot proxies its requests to the server.

To create such a configuration, you must first assign a general proxy backend server. Then, assign other backend servers to the related service group. For example, you can assign the server as the general proxy backend server. You can then assign the server as the Mail service group’s proxy backend server.

Service proxy groups

Service proxy groups consist of a group of one or more related services:


The Mail service group consists of the Dovecot service, which handles the IMAP and POP3 protocols.

  • This service proxy group does not include Exim.
  • While you cannot proxy SMTP, you can configure a manual MX redirect. To do this, use the WHM API 1 set_manual_mx_redirects function.

Unsuspend an account

To remove service proxying, unsuspend the account. For example, the Live Transfer feature proxies services to the destination server. The feature then suspends the account. You can unsuspend the account on the source server to disable proxying.

Additional Documentation