Managing Applications

What are Applications?

Applications created via the control panel are used to run your sites. An application can take many forms, such as a directory of static files, a PHP script (or several), or even a complex back-end server spawning several long-running processes.

You serve applications from your sites by assigning them to site routes. Please refer to Building A Site for more information.

Adding an Application

1

Create a shell user if you have not done so already. You can use an existing shell user if you wish.

2

Click on Applications in the control panel sidebar

3

Click the button labeled "+ Add Application" in the upper-left corner of the content area.

4

Select the type of application that you want to install.

At this time there are three basic types of applications available:

  • A PHP-FPM+Apache application is a directory which hosts PHP scripts and static content. When the application is added to a website, the frontend Nginx web server is automatically configured to serve your PHP scripts from your application directory via PHP-FPM from a backend Apache web server. This application type is most commonly used to serve PHP applications.
  • A Nginx static only application is a directory which hosts static content. When the application is added to a website, the frontend Nginx web server is automatically configured to serve your static content directly from your application directory. This application is most commonly used to serve purely static HTML sites and static assets alongside dynamic applications.
  • A Proxy Port application is a directory which store your application files along with a network port assignment for your application. When the application is added to a website, the frontend Nginx web server is automatically configured to transparently proxy requests and responses to and from your application. This application is most commonly used to serve sites powered by long-running processes listening on a network port.

Many more application types will be added to the control panel in the near future, but these three basic types are the foundation for all of them.

5

Some application types will present additional options when they are selected.

Read the on-screen documentation for the options and set them as desired. Unless otherwise noted, it's generally safe to accept the default options.

6

Enter a name for your application in the Name field.

This name will be used to create a subdirectory in your shell user's apps directory such as /home/username/apps/appname.

7

Select the shell user that will host the application.

If you have multiple servers, be sure to select the shell user that is located on the server from which you intend to serve your site.

8

Click the "Add Application" button to save your new application.

A notification will appear in the control panel when the application is ready. This may take a minute or longer, depending on the complexity of the application.

Deleting an Application

1

Click on Applications in the control panel sidebar.

2

Click the checkbox next to the application (or applications) that you want to delete. A "Delete Selected" button will appear above the application list.

3

Click the "Delete Selected" button.

4

Type "I confirm" in the confirmation dialog.

After you have typed the confirmation phrase, the field border will turn green and a "Delete" button will appear.

5

Click the "Delete" button to queue the selected applications for deletion. The applications will be permanently deleted in 24 hours.

Once you have queued applications for deletion, two new icons will appear for those applications in the application list:

These icons can be used to undo or accelerate the deletion process:

  1. The Recover icon: click to remove your application from the deletion queue.
  2. The Delete Now icon: click to delete the application immediately.