You can find our user documentation at

Check out our new API beta site!

Child pages
  • Application Manager
For cPanel & WHM version 72
Skip to end of metadata
Go to start of metadata

(cPanel >> Home >> Software >> Application Manager)


This interface allows you to deploy Ruby applications with the Phusion Passenger® application server. A Phusion Passenger server functions as a process manager, reverse proxy, and provides operations tools to its users. 

To deploy an application, the following conditions must exist on your server:

  • Your server must run EasyApache 4.
  • Your hosting provider must install the following modules:
    • The ea-ruby24-mod_passenger  module.


      This module disables Apache's mod_userdir module.

    • The ea-ruby24-ruby-devel module.
    • The ea-apache24-mod_env module.


      This module allows you to add environment variables when you register your application. For more information about environment variables, read the Environment Variables section below.

  • Your hosting provider must also enable the Application Manager feature in WHM's Feature Manager interface (WHM >> Home >> Packages >> Feature Manager).

Create an application

You must create an application before you register it in the Application Manager interface. For example, you could perform one of the following actions:

In This Document

Related Documentation

There is no content with the specified labels

For Hosting Providers

There is no content with the specified labels


Applications that you create with the following interfaces will not function with the Application Manager interface:

    • cPanel's Ruby on Rails interface (cPanel >> Home  >> Software >> Ruby on Rails).
    • cPanel's RubyGems interface (cPanel >> Home  >> Software >> RubyGems).
    • The Ruby Gem installer in WHM's Module Installers interface (WHM >> Home >> Software >> Module Installers).

We plan to remove these interfaces in a future cPanel & WHM version.

Register an application

To register an application, perform the following steps:

  1. Click Add Application. A new interface will appear.

  2. Enter the application's name in the Name text box. 
  3. From the Domain menu, select the main domain, addon domain, or subdomain to which to deploy the Ruby application.
  4. Enter the application's base URL in the Application URL text box. After you register the application, enter this URL in a web browser to access the application.

  5. Enter the filepath, relative to the home directory, for the file where your application's source code resides in the  Path to Application text box. 

  6. Click Production or Development to choose the server environment in which the Ruby application runs. 
    • Click Development if you need to continue to develop your application. 
    • Click Production if you wish to deploy and use your application.
  7. If you wish, add environment variables under the Environment Variables heading. 
  8. Click Save Application.

Environment Variables


To add environment variables, your system administrator must install the ea-apache24-mod_env RPM Apache module.

Environment variables allow you to configure the processes that the application runs on multiple systems.  

The Environment Variables table contains the following information:


The environment variable's name.


An environment variable name must meet the following criteria:

  • The name can only contain letters, numbers, underscores, and dashes.
  • The name must contain 256 characters or fewer.
  • The name cannot begin with a number.

The environment variable's value.


An environment variable value must contain 1024 or fewer ASCII-printable characters.


Use the links in this column to perform the following actions:

  • Edit — Edit the environment variable.
  • Delete — Delete the environment variable.

For more information about environment variables, read Passenger's Environment Variables documentation.

Add environment variables

To add an environment variable to the application's configuration file, perform the following steps:

  1. In the Environmental Variables section, click Add Variable.
  2. Enter the variable's name in the Environment Variable Name text box.

  3. Enter a value for the variable in the Environment Variable Value text box and click Save.
  4. Click Save Application.

Edit an application

To edit an application's configuration file, perform the following steps:

  1. In the table below the Search text box, locate the Ruby application that you wish to change.
  2. Under the Actions column, click Edit. A new interface will appear.
  3. Make the desired changes.

  4. Click Save Application.

Unregister an application

To unregister an application, perform the following steps:


This action deletes an application's configuration file, but does not delete an application.

  1. In the table below the Search text box, locate the application that you wish to unregister.
  2. Click Delete. A confirmation message will appear.
  3. Click Continue to completely unregister the application. A success message will appear.