Using The Application Manager Feature in cPanel

Manage and configure Ruby, Node.js, or Python applications

Simplify your app management process

Updated: April 23, 2025
By: RSH Web Editorial Staff

Contact Us

Menu

cPanel - Software - Application Manager

Application Manager

The Application Manager interface facilitates the deployment of applications via the Phusion Passenger® application server, which operates as a robust process manager and reverse proxy, while also providing advanced operational tooling. It is designed for environments running either Apache or NGINX® web servers

cPanel Application Manager

Requirements

Your hosting provider must select the Application Manager feature in WHM’s Feature Manager interface and install one of the following Apache modules, depending on your operating system:

Package Description
ea-apache24-mod-passenger This package works on systems that run Ubuntu®, AlmaLinux OS 9 or Rocky Linux™ 9.
ea-ruby27-mod_passenger This package only works on systems that run AlmaLinux 8 or Rocky Linux 8.

If needed, your provider should also install the following packages:

Package Description
ea-apache24-mod_env This module allows your application configuration to set environment variables for your application.
ea-nodejs16
ea-nodejs18
ea-nodejs20
ea-nodejs22
These packages provide Node.js™ application support.

When you install a Node.js package, it will uninstall any other Node.js packages. You must update any existing applications to use the new version of Node.js. Any new applications will use the newest installed version of Node.js.
Python™ Install the appropriate version of python for your applications.

The Application Manager uses /usr/bin/python3 by default if it exists. If it does not exist, the Application Manager uses /usr/bin/python by default. If you want to use another version by default, add the path to your preferred version with the following command: echo -n /path/to/python > /etc/cpanel/ea4/passenger.python

Note: For additional setup and troubleshooting information, read cPanel's Using Passenger Applications documentation.

Applications

This table contains the following information:

Item Description
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 these actions to make application changes.

Actions

Action Description
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:

Register an application

This feature configures new applications with the most recent version of Ruby on your system. The installed version of Passenger determines which version of Ruby the system uses. You can’t have more than one version of Passenger installed.

Existing applications will not change their Ruby version. If you uninstall an application’s version of Ruby, your applications will no longer function.

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 hosting provider must install the ea-apache24-mod_env 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:

Item Description
Variable Name 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.
Value The environment variable’s value.
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.

Log files

You can find your application’s log files in the following locations. In these paths, replace the example directory with the name of the directory where your application is located. You can view these files in cPanel’s File Manager interface (Home » Files » File Manager):

Application Log location
Node.js example/logs/
Python example/stderr.log

Related cPanel Tutorials and How To Guides
Manage, tweak, and increase the security and performance

Tweet  Share  Pin  Email

Add Comment

* Required information
1000
Drag & drop images (max 3)
Powered by Commentics

Comments

No comments yet. Be the first!

From the minds of our master copywriters

As the leading provider of cPanel hosting solutions, RSH Web Services provides a full range of hosting products for any business, personal or professional website. From domain name registration to high security and easy management