Application Manager

Valid for versions 90 through the latest version

Version:

82

84

90


Last modified: July 21, 2020

Overview

This interface allows you to deploy 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.

This interface works on servers that run Apache and Nginx.

Important:

Your hosting provider must select the Application Manager feature in WHM’s Feature Manager interface and install the ea-ruby24-mod_passenger Apache module.
If needed, your provider should also install the following packages:

  • ea-apache24-mod_env — This module allows your application configuration to set environment variables for your application.
  • ea-nodejs10 — This module supports NodeJS applications.
  • python — Install the appropriate version of python for your applications.

If you need this feature, contact your hosting provider.

Applications

This table contains the following information:

  • Name — The application’s name.
  • Domain — The application’s domain.
  • Path — The file where the application’s source code resides, relative to the home directory.
  • Status — Whether the application is enabled or disabled.
  • Actions — Use the items in this column to perform the following actions:
    • Edit — Edit the application.
    • Unregister — Unregister the application.
    • Enable Dependencies — Confirm and, if necessary, install an application’s Node.js package manager (npm) dependencies.

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:

Warning:

Anything you create in these interfaces won’t work with the Application Manager feature:

  • cPanel’s Ruby on Rails interface (cPanel >> Home >> Software >> Ruby on Rails).
  • cPanel’s RubyGems interface (cPanel >> Home >> Software >> RubyGems).
  • The Ruby Gem installer section of 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 Register Application. A new interface will appear.
  2. Enter the application’s name in the Application Name text box.
  3. From the Deployment Domain menu, select the main domain, addon domain, or subdomain to which to deploy the application.
  4. Enter the application’s base URL in the Base Application URL text box. After you register the application, enter this URL in a web browser to access the application.
  5. Enter the path to your source code directory, relative to the home directory, in the Application Path text box.
  6. Select a deployment environment. This sets the server environment that the application runs in.
    • Click Development if you’re still developing your application.
    • Click Production if you’re ready to deploy and use your application.
  7. If you want to add environment variables, click Add Variable in the Environment Variables section.
  8. Click Deploy.

Environment Variables

Warning:

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:

  • Variable Name — The environment variable’s name.
    Important:

    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.
  • Value — The environment variable’s value.
    Important:
    An environment variable value must contain 1024 or fewer ASCII-printable characters.
  • Actions — Use the items in this column to perform the following actions:
    • Edit — Edit the environment variable.
    • Unregister — Delete the environment variable.

For more information about environment variables, read Phusion 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 in the Variable Name column.
  3. Enter a value for the variable in the Environment Variable Value text box in the Value column.
  4. Click Save in the Actions column.

Edit an application

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

  1. In the table of applications, find the application that you want to edit.
  2. In the Actions column, click Edit. A new interface will appear.
  3. Make the desired changes.
  4. Click Deploy.

Unregister an application

Important:

Unregistering an application removes it from the list and deletes its configuration file. It does not delete the application.

To unregister an application, perform the following steps:

  1. In the table of applications, locate the application that you wish to unregister.
  2. Click Unregister. A confirmation message will appear.
  3. Click Unregister to completely unregister the application. A success message will appear.

Additional Documentation