How to set cPanel to use ProxyPass for Ruby or any other backend server apps?


Apr 12, 2013
cPanel Access Level
Root Administrator
I have a Ruby app that needs to run on a cPanel host. I do have root access to the server.

I would like to be able to set a subdomain to utilize ProxyPass to allow me to run unicorn or any other server I wish for this Ruby app (and later I will be running nodejs apps), however the instructions here do not seem entirely clear.

For example, in the section "Custom Templates for Subdomains and Addon Domains", it notes that we should follow 3 steps, however to where do we copy the `vhost.default` or `ssl_vhost.default`? So for example, if I have example.tld, which runs fine normally on the default Apache cPanel setup, but I have another.example.tld that I want to pass through to a ruby backend, what precisely do I do?

I believe that it should be as simple as inserting

ProxyPass /
into this file once I figure out where it should go and then run an incantation like:

usr/local/cpanel/bin/apache_conf_distiller --update
Correct? I would very much appreciate some exact steps and configuration options that should go in the file as well if you are able to shed any additional light on the subject.


Staff member
Apr 11, 2011
Hello :)

If you are editing a single VirtualHost instead of editing the default template for new VirtualHosts, then you can follow the instructions at:

Changes Contained Within a VirtualHost Directive

Focus on the "Using Include Files" and "For an individual VirtualHost container" section of this document. After creating the file for the appropriate domain/username and version of Apache, you can insert your custom line to that file, and then run the following commands:

/usr/local/cpanel/bin/apache_conf_distiller --update
No additional steps are required, and the change you made should be active.

Thank you.