SERVERS AND SERVICES

Application role

Last updated: September 2022

Support documentation / Application role

About

During installation of Enhance the Application role is automatically installed on your first server.


The Application role provides the following services:

  • HTTP (Apache 2.0)
  • PHP FPM (one per website, where the website has PHP enabled)
  • Screenshotd (internal Enhance service responsible for maintaining a screenshot of website added to the platform)
  • FTP (pure-ftpd)
  • Filerd (internal service which powers the web based file manager)
  • OpenSSH (This allows customer SSH access) Root access is not permitted through this SSH server and instead you must use the host SSH server which is moved to port 2222 upon initial Enhance installation.

Installing Application role

ℹ️ To run the Application role on a server allow port 80, 443, 22 and 21 on your firewall.

The Application role can be installed on an existing or new server.


To add a Application role to a new or existing server:

  1. Click 'Servers' in the left side bar
  2. Choose the server that you want to add the backup role to
  3. Click 'Add role' and select the 'Application' check box. Complete the form and hit 'Add role'

ℹ️ You can navigate away from the server page when a service is being installed and you will be notified when the installation is completed.

ℹ️ The Application role will not automatically be mapped to websites. If you are installing a role which did not previously exist on your Enhance estate and you want to map existing websites to it so they can use the new functionality, use the "Move server" option from the left hand menu.

Application settings

The Application role automatically inherits Enhance's global Service settings. php-fpm and php.ini settings can be overridden on a per server basis.

To configure global Application settings:


  1. Open 'Settings' in the left sidebar
  2. Select 'Service' settings in the menu
  3. Navigate to the 'Application' section.

To override global Application settings on a per server basis:

  1. Open ‘Servers’ in the left side bar
  2. Select ‘Manage’ on the server
  3. Navigate to the ‘Role’ you’d like to configure custom settings for
  4. Click ‘Settings’

Any settings that are inherited by the global Application settings will be tagged 'Default'.

php.ini custom

php.ini

The default file for running application that require PHP.

PHP-FPM

Directives for the FPM pool that websites run under.

Screenshot interval
The frequency at which a website's screenshot will be taken. The screenshot is used in the UI.

Screenshot driver pool

The number of screenshot worker processes per Application server.

Automatically provision Let's Encrypt

This will automatically request a certificate for website and server domains with no existing certificates or a certificate that is due to expire.

PHP versions

Enhance currently supports the following PHP versions. More are being added.

  • PHP 8.0
  • PHP 7.4
  • PHP 5.6

Each website has control of its own PHP version. By default, 7.4 is configured on all new websites. Additional domains mapped to a website (add-on domains) use the same PHP version as the primary (root) domain.

Recompiling PHP

It is currently not supported to compile a custom PHP. If you require a module which is not included in our standard configuration please raise a support ticket.

Troubleshooting

Unable to connect to FTP

If you have a firewall (local or external), allow the FTP passive port range inbound, 30000:31000.

Still need help?

Our support team are on hand to help 9am - 9pm GMT.