We have a new documentation site for cPanel & WHM! You can find our new documentation site at docs.cpanel.net.
We will continue to maintain our API documentation on this server.
You can perform the following actions on applications in the Ruby on Rails Applications table:
Because Ruby on Rails uses its own server and does not respond on the standard HTTP port number
80, you must specify the port where site visitors can access your Ruby on Rails application (for example,
To configure Ruby to respond without the need for visitors to specify a port number, create a rewrite.
To configure a rewrite, perform the following steps:
You can perform the following actions in the Current Rewrites table:
To run multiple Ruby applications, you must configure additional ports to respond with Ruby on Rails and, if necessary, additional rewrites to disguise the port change.
The new application will respond on the next available port number (for example, if your first application runs on port
12001, the second may run on port
12002 or higher).
Ruby application port numbers increment automatically with every new application. If you are on a shared server, the system assigns the next available port number to your application. Also, your applications' port numbers may not be consecutive.
To configure an additional rewrite, follow the steps in the Create a Rewrite section.
You will need to use a new domain, addon domain, subdomain, or page (for example,
example.com/RubyApplication) for the rewrite.
You cannot configure two Ruby applications to respond on the same domain, subdomain, addon domain, or page.
You can limit the number of Rails applications that your customers can install in WHM's Modify an Account interface (WHM >> Home >> Account Functions >> Modify An Account). Perform the following steps to set the maximum number of Rails applications: