Extensions Catalog

Note: This topic describes the Extensions Catalog available in Plesk Onyx 17.5 and later. If you are running an earlier version of Plesk Onyx, refer to the Plesk Extensions topic instead.

Plesk extensions are independent modules that add new functions and features to Plesk. They are created both by Plesk and numerous Plesk partners (in fact, anyone can create and publish their own Plesk extension in the Extensions Catalog using the publicly available documentation). You can install any number of extensions on your Plesk server.

Next in this section:

Do I Need Extensions?

Are Extensions Safe?

Are Extensions Free?

Extensions Catalog

Learning More About an Extension

Installing Extensions

Using Extensions

Configuring Extensions

Updating Extensions

Promoting Extensions

Disabling Extensions

Removing Extensions

 

Do I Need Extensions?

Plesk extensions can only be installed by the Plesk administrator. Some extensions add functions that can only be used by the Plesk administrator, while others add additional capabilities to reseller and customer accounts.

 

Are Extensions Safe?

All extensions in the Plesk Extensions Catalog, whether published by Plesk, a Plesk partner, or a third party are rigorously vetted and tested. You can always rely on them to be 100% safe. However, you must be careful with extensions that come from other sources. Plesk recommends you only install extensions from sources you trust.

 

Are Extensions Free?

In short, some are and some are not. The extension's author determines whether the extension is free or paid, chooses the licensing model, and sets the price.

A number of extension licensing models are available:

 

Extensions Catalog

The Extensions Catalog is an online repository of Plesk extensions that is publicly available at https://ext.plesk.com/. You can also access the Extensions Catalog from Plesk by clicking Extensions in the navigation pane.

The Extensions Catalog UI in Plesk Onyx 17.5 differs from the one in Plesk Onyx 17.8.

Plesk Onyx 17.5

After clicking Extensions in the navigation pane, you will land right on the Extensions Catalog tab. Here you can access a wealth of extensions that add all kinds of functions and features to Plesk. Extensions are sorted into categories, such as "Backup", "DNS", or "Mail". Every extension belongs to one or more categories.

Featured extensions are displayed on the landing page. However, many categories contain more extensions that can be displayed. To find a specific extension, use the search function (the search window is located in the top right corner).

If you do not know the name of the extension you are looking for, look for the "Select Category" menu and select the category you think the extension is most likely to belong to.

Plesk Onyx 17.8

ex

After clicking Extensions in the navigation pane, you will land right on the Extensions Catalog tab, the Featured screen. Here you can access a wealth of extensions that add all kinds of functions and features to Plesk. Extensions are sorted into four groups, each one found on its own screen accessible from the Extensions Catalog tab:

To find a specific extension, use the search function (the search window is located in the top right corner).

ex1

If you do not know the name of the extension you are looking for, go to the Categories screen and select the category you think the extension is most likely to belong to.

Alternatively, you can find specific extensions using the Plesk global search located in the top left corner.

1

The Plesk global search shows both installed and non-installed extensions:

If you do not know the name of the extension you are looking for, you can use the Plesk global search function to search for the extension by the category you think the extension is most likely to belong to.

3

Customizing the My Extensions Screen

All extensions installed in Plesk are displayed in Extensions > My Extensions. In Plesk Onyx 17.8, you can customize the “My Extensions” screen by rearranging the extensions. You can create your own layout of the “My Extensions” screen.

To customize the “My Extensions” screen:

  1. Go to Extensions > My Extensions and click the Customize button in the upper right corner.
  2. Drag and drop the extensions to rearrange them.
  3. When you are satisfied with the “My Extensions” screen layout, click Done to save it.

    New Bitmap Image

Creating Extensions

No extension to suit your taste? You have two options:

Plesk Onyx 17.5

Click Extensions and look for the "Request Extension" section in the bottom right corner.

Plesk Onyx 17.8

Go to  Extensions > Categories and look for the "Let us know if you couldn't find the extension to suit your needs." section at the bottom of the screen.

Click the "Let us know" link, and you will be taken to the Plesk UserVoice page. There, you can leave a request describing the extension you are looking for. Other Plesk users may vote for your request, and the more votes it receives, the greater the chance that Plesk will create and publish the extension you request. However, please note that regardless of the number of votes, the final decision about whether to create the extension remains with Plesk. Plesk will also not give any guarantees or ETAs.

 

Learning More About an Extension

To learn more about an extension, locate it in the Extensions Catalog and click the extension name.

3

On the extension's page, variety of information about the extension is available. Pay attention to the following:

Many extensions also provide one or more useful links:

 

Installing Extensions

While most Plesk extensions can be installed and function equally well on both Linux and Windows servers, some can only work on one or the other. Other extensions may lose some of their functions and features if installed on a specific OS.

In addition, every extension has a minimum Plesk version it can operate on, and will not work if installed on a server running an earlier Plesk version. For example, an extension requiring " Plesk 12.0 +" will work on Plesk 12.0, Plesk 12.5, and Plesk Onyx, but not on Plesk 10.4.

When installing extensions from the Extensions Catalog, extensions for which you do not meet the installation requirements are not displayed. When installing an extension from a file, you need to make sure that the installation requirements are met. To learn about an extension's installation requirements, look it up in the Extensions Catalog or contact the extension's vendor.

To install an extension from the Extensions Catalog, follow these steps:

  1. Click Extensions.
  2. Look for the extension you want to install.
  3. Click Install to install the extension. If you see the "Buy Now" button, it means that the extension requires a paid license to activate some or all of its features.

To install an extension from a file, follow these steps:

  1. Click Extensions and go to My Extensions.
  2. Click Upload Extension. Select the file containing the packaged extension you want to install, and click Ok.

Caution: Installing extensions from sources other than the Extensions Catalog can be insecure, and may allow a third party to compromise your server. Never install extensions from sources you do not trust.

Paid Extensions

If you install a paid extension, you may need to purchase a license to take advantage of some or all features and functions it provides. You can purchase a license on the extension's page by clicking the Buy button.

4

If you are unsure whether an extension requires a license or not, read the extension's documentation or contact the extension's vendor.

In Plesk Onyx 17.8 and later, certain extensions allow you to upgrade the installed license. This can help you to:

To upgrade an extension's license:

  1. Click Extensions > My Extensions.
  2. Click the extension whose license you wish to upgrade.
  3. Click Upgrade and buy the desired license.

    1

 

Using Extensions

Okay, you have installed an extension - now what? This depends on the extension in question. Some Plesk extensions can operate out of the box, and some require configuration before they can be used. The way you operate an extension and take advantage of the functions and features it provides varies from extension to extension.

If you are unsure how to use the extension you have installed, read the extension's documentation or contact the extension's vendor. If you have installed an extension but are unable to make use of one or more advertised features, make sure that you are running the latest version of the extension and update it, if necessary.

 

Configuring Extensions

Many extensions have a number of configurable settings. The exact settings vary greatly from extension to extension. Usually, they govern the way the extension behaves, but sometimes they present the entirety of the extension's interface (that is, you need to go to the extension's configuration screen to operate it).

To change the settings of an installed extension, follow these steps:

  1. Click Extensions in the navigation pane and go to My Extensions.
  2. Select the extension you want to configure and click Go To Extension.

If you are unsure what a specific option or setting does, read the extension's documentation or contact the extension's vendor.

 

Updating Extensions

After an extension is published, its vendor can release updates that bring new features, security improvements, bugfixes, and more. Updates for extensions are always free, and Plesk recommends keeping all installed extensions up-to-date.

To see if there are any updates available for the installed extensions, click Extensions in the navigation pane. When updates become available for one or more installed extensions, a notification is displayed on the "Updates" tab. The number within the red square indicates the number of extensions for which updates are available.

To see which extensions can be updated, go to Updates.

The important information here is the name of the extension, the version that is currently installed, and the version that is available. You can click "Show Change Log" to see a list of bugfixes and improvements that will be delivered with the update.

When an update for an extension is released, if automatic update is enabled on the server, the extension is updated within a week. If you do not want to wait, you can update the extension manually.

Updating extensions automatically

By default, automatic extensions update is enabled. This means that once a week, Plesk checks for updates for all installed extensions and automatically installs all updates that are found. If you need to update an extension immediately, check for updates manually, as described later in this topic.

If you are concerned that installing an update may disrupt the operation of an extension, or you want to test the updated extension in a staging environment first, you may want to disable automatic update. To do so, click Extensions in the navigation pane, go to Updates, and then click the green "Auto-update" slider.

If you change your mind, click the gray slider to turn automatic update back on.

Updating extensions manually

To update an installed extension manually, follow these steps:

  1. Click Extensions in the navigation pane and go to Updates.
  2. Click Check Now to check the availability of updates for all installed extensions.
  3. Select the extensions you want to update and click Update.
Updating extensions not found in the Extensions Catalog

Note that the procedures described above are only suitable for extensions that are present in the Extensions Catalog. The only way to update an extension not found in the Extensions Catalog is to upload a newer version of the extension as a file.

 

Promoting Extensions

Plesk Onyx 17.8 uses extensions promos to suggest extensions you may want to try. The promos are context-dependent and are only displayed on certain Plesk pages. For example, you can see promos of extensions related to backups (such as Perfect Dashboard and Dropbox Backup) on the Tools & Settings > Backup Manager screen.

To install a promoted extension, click Install. If the extension is paid, click Buy to buy a license.

promo

If you do not want to see these promos, add the following lines to the panel.ini file:

[ext-catalog]
contextAds = off

 

Disabling Extensions

If you want to temporarily stop using an installed extension without removing it, you can disable it. You may want to disable an extension, for example, in one of the following situations:

Disabling an extension preserves its configuration and data, but removes all controls associated with it from the Plesk interface. The exact consequences of disabling an extension differ depending on the extension in question.

To disable an installed extension, follow these steps:

  1. Click Extensions in the navigation pane and go to My Extensions.
  2. Select the extension you want to disable and click Disable.

To enable a disabled extension, follow these steps:

  1. Click Extensions in the navigation pane and go to My Extensions.
  2. Select the extension you want to enable and click Enable.
 

Removing Extensions

If you no longer want to use an installed extension, you can remove it. When you remove an installed extension, all extension data are removed (what exactly is considered extension data varies from extension to extension - see the examples below for reference). In addition, when an extension is removed, all controls associated with it are removed from the Plesk interface.

Plesk recommends that before you remove an extension, you should disable it for a few days. If you notice no adverse effects during this time, you can safely remove the extension.

Caution: When an extension is removed, all data for that extension are irrevocably lost.

To remove an installed extension, follow these steps:

  1. Click Extensions in the navigation pane and go to My Extensions.
  2. Select the extension you want to remove and click Remove.

The exact consequences of removing an extension differ depending on the extension in question. Here are a few examples: