title: Application Manager created at: Mon Oct 21 2024 11:02:09 GMT+0000 (Coordinated Universal Time) updated at: Sat Feb 08 2025 14:22:17 GMT+0000 (Coordinated Universal Time) --- # Application Manager # Overview This interface allows you to deploy applications with the [Phusion Passenger](https://www.phusionpassenger.com/) 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. ## Requirements Your hosting provider **must** select the *Application Manager* feature in WHM’s [*Feature Manager*](https://docs.cpanel.net/whm/packages/feature-manager) interface and install **one** of the following [Apache modules](https://docs.cpanel.net/ea4/apache/about-apache/#apache-modules) , depending on your operating system: | Package | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ea-apache24-mod-passenger` | This [package](https://docs.cpanel.net/knowledge-base/web-services/using-passenger-applications) works on systems that run [Ubuntu](https://docs.cpanel.net/installation-guide/system-requirements-ubuntu/) , [AlmaLinux OS 9](https://docs.cpanel.net/installation-guide/system-requirements-almalinux/) or [Rocky Linux 9](https://docs.cpanel.net/installation-guide/system-requirements-rockylinux/) . | | `ea-ruby27-mod_passenger` | This package **only** works on systems that run [AlmaLinux 8](https://docs.cpanel.net/installation-guide/system-requirements-almalinux/) or [Rocky Linux 8](https://docs.cpanel.net/installation-guide/system-requirements-rockylinux/) . | 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](https://docs.cpanel.net/cpanel/software/application-manager/#environment-variables) for your application. | | `ea-nodejs16`<br />`ea-nodejs18`<br />`ea-nodejs20`<br />`ea-nodejs22` | These packages provide Node.js application support.<br />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.<br />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:<br />`echo -n /path/to/python > /etc/cpanel/ea4/passenger.python` | > \[!NOTE] > Note > For additional setup and troubleshooting information, read our [Using Passenger Applications](https://docs.cpanel.net/knowledge-base/web-services/using-passenger-applications/) documentation. If you need this feature, contact your hosting provider. # 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](https://docs.cpanel.net/cpanel/software/application-manager#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)](https://wikipedia.org/wiki/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: * Clone an existing application from GitHub with our [*Git Version Control*](https://docs.cpanel.net/cpanel/files/git-version-control) interface (*cPanel » Home » Files » Git\_\_ Version Control*). * Create a new application on your server. For an examples of how to do this, read the following documentation: * [How to Create Ruby Web Applications](https://docs.cpanel.net/knowledge-base/web-services/how-to-create-ruby-web-applications/) * [How to Install a Python WSGI Application](https://docs.cpanel.net/knowledge-base/web-services/how-to-install-a-python-wsgi-application/) * [How to install a Node.js Application](https://docs.cpanel.net/knowledge-base/web-services/how-to-install-a-node.js-application/) > \[!CAUTION] > Warning > Anything you create in these interfaces won’t work with the *Application Manager* feature: > cPanel’s [*Ruby on Rails*](https://docs.cpanel.net/cpanel/software/ruby-on-rails) interface (*cPanel » Home » Software » Ruby on Rails*). > cPanel’s [*RubyGems*](https://docs.cpanel.net/cpanel/software/rubygems) interface (*cPanel » Home » Software » RubyGems*). > The *Ruby Gem installer* section of WHM’s [*Module Installers*](https://docs.cpanel.net/whm/software/module-installers) interface (*WHM » Home » Software » Module Installers*). > We plan to remove these interfaces in a future cPanel & WHM version. # 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 > \[!CAUTION] > 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.<br />An environment variable name must meet the following criteria:<br />- The name can **only** contain letters, numbers, underscores, and dashes. <br />- The name **must** contain 256 characters or fewer. <br />- The name **cannot** begin with a number. | | *Value* | The environment variable’s value.<br />An environment variable value **must** contain 1024 or fewer ASCII-printable characters. | | *Actions* | Use the items in this column to perform the following actions:<br />- *Edit* — Edit the environment variable. <br />- *Unregister* — Delete the environment variable. | For more information about environment variables, read Phusion Passenger’s [Environment Variables](https://www.phusionpassenger.com/library/indepth/environment_variables.html) 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 > \[!WARNING] > 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*](https://docs.cpanel.net/cpanel/files/file-manager) interface (*Home » Files » File Manager*): | Application | Log location | | ----------- | -------------------- | | Node.js | `example/logs/` | | Python | `example/stderr.log` |