Personal tools
Namespaces

Variants
Actions

Portainer Docker Containers For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
(Installation)
(Products)
Line 119: Line 119:
 
It allows you to add products to the module, enabling the creation of checks for services associated with those products.<br/> It also features several management tools like the queue, translations tool and module logs.
 
It allows you to add products to the module, enabling the creation of checks for services associated with those products.<br/> It also features several management tools like the queue, translations tool and module logs.
 
|}
 
|}
===Products===
+
===App Templates===
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|To start creating checks, the module functionality must first be enabled for specific products.
+
|style="padding: 10px 0px 5px 15px;"|'App Templates' allow you to manage and ultimately provide applications, ISO images, operating systems, and snapshots to your clients.<br/>
This step is crucial as it defines how checks can be configured later on.<br/>
+
Prepare templates in the '' 'Applications' '' tab and gather them into groups in the '' 'Groups' '' tab.<br/>
Start by navigating to the '' 'Products' '' tab and clicking on the '' 'Add Product' '' button.
+
For clients to be able to install templates on their VPS, their product has to include an '' '[[#ATC|Application Group]]' '' and allow '' '[[#CAF|App Templates]]' '' in the client area.
 
|}
 
|}
 +
====Applications====
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:SM_13.png]]
+
|style="padding: 10px 0px 15px 15px;"|Read the guide carefully, as it contains crucial information on how to use 'App Templates'.<br/>
 +
You can change the settings and have the guide collapsed by default. Clicking on the '' 'Additional Actions' '' button, select '' 'Options' '' and '' 'Collapse Guide'.''
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|Fill out the necessary fields as you add the products:
+
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_8.png]]
*'''Status''' - set the initial status for the products, this can be changed later.
+
*'''Enable Graph Widget''' - enable a widget in the client area to display a 30-day graph comparing successful and failed checks for the service.
+
*'''Products''' - include the products you wish to add with this configuration. <br/> If you add more than one product in a single bundle, they will still be listed by one on the list of products, allowing configuration per product.
+
*'''Number of Failures Triggering Notification''' - set the amount of failed checks needed to trigger a notification.<br/>The number you set for the product here will be the minimum clients can set for their services.
+
*'''Checks Number Limit for Clients''' - limit how many checks clients can set up for their services.
+
*'''Verification Interval''' - set the minimum check interval clients can set for their services.
+
*'''Minimum Notification Delay''' - set the minimum time, in minutes, between notifications triggered by users.
+
*'''Available Check Types''' - select which check types will be available to set up.
+
**cURL Check - an HTTP GET request is sent to a server to retrieve data and check its availability.
+
**ICMP Ping Check - an ICMP ping is sent to a specific IP address to test if the server is reachable.
+
***Allow Custom IP Address - allow the client to enter a custom IP address instead of selecting from assigned ones.
+
**Socket Ping Check - a connection attempt is made to a specific IP address and port to check if the service is running and accessible.<br/>'''''Important:''' This check type requires specific configuration, see the [[#Tips|Tips]] section for details.''
+
**Port Connect - a connection attempt is made to a specific IP address and port using the TCP protocol to verify if the service on the specified port is running and accessible.
+
***Allow Custom IP Address - allow the client to enter a custom IP address instead of selecting from assigned ones.
+
*'''Available Notifications''' - include allowed notification types.
+
**Email Notification - send email messages when the checks fail, and when the service recovers.
+
***Email Template for Failed Checks - decide which email template will be used when the failed check threshold is exceeded.<br/>The default email template is named '' 'Server Monitoring - failed checks alert','' it includes merge fields and can be freely edited.
+
***Email Template for Service Recovery - decide which email template will be used when the service has recovered.<br/>The default email template is named'' 'Server Monitoring - service unreachable','' it includes merge fields and can be freely edited.
+
**SMS Notification - enable SMS notifications to keep clients informed of monitoring events.<br/>'''''Note:''' SMS notifications require [https://www.modulesgarden.com/products/whmcs/sms-center SMS Center For WHMCS].''
+
***Message Template for Failed Checks - choose the SMS template used to notify clients when a check fails.
+
***Message Template for Service Recovery - choose the SMS template used to notify clients when a service recovers following downtime.
+
***Number of Phone Slots - set how many phone number slots are available for adding multiple numbers.
+
***API Execution Admin - select the admin account that will execute API requests.
+
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:SM_14.png]]
+
|style="padding: 0px 0px 20px 15px;"|You can switch between Applications, ISO Images, Operating Systems, and Snapshots by clicking on relevant tabs.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 15px;"|Once products are added, you can disable/enable them with the '' 'Status' '' toggle.
+
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_9.png]]
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:SM_15.png]]
+
|style="padding: 0px 0px 20px 15px;"|You can use the refresh button to download and later refresh templates from the server.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 15px;"|Use the action buttons to edit or delete products from the list.
+
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_10.png]]
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 25px;"|[[File:SM_16.png]]
+
|style="padding: 0px 0px 15px 15px;"|Once the items are loaded, you can use the action buttons to edit, duplicate or delete them from the list.<br/>
 +
You can also use the mass action buttons to manage multiple templates at once.
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 15px;"|You can also delete multiple products with the mass action button.
+
|style="padding: 0px 0px 30px 25px;"|[[File:VT_19_11.png]]
 
|}
 
|}
 +
 +
====Groups====
 
{|
 
{|
|style="padding: 0px 0px 30px 25px;"|[[File:SM_16_1.png]]
+
|style="padding: 10px 0px 15px 15px;"|With the templates ready, all that is left is to gather them into groups and include said groups into products.<br/>
 +
Navigate to '' 'App Templates' '' → '' 'Groups' '' and click on the '' 'Create' '' button.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_15.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Read the information, then provide the group with:
 +
*Name
 +
*Description
 +
*Items to include
 +
'''''Note:''' Keep in mind that Vultr includes Windows licenses (Core and Standard) in their Plans and charges a monthly fee for them.''<br/>''Since this will affect the Plan price, we recommend not including Windows with other systems in one product.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_16.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|You can use the action button and the mass action function to edit and delete groups.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_17.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|For the client to take advantage of the application templates, the product [[#ATC|module settings]] have to include the group.<br/>
 +
Find the '' 'App Templates Configuration' '' section and '' 'Default Application Group' '' field.<br/>
 +
Include a chosen group for the product.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_18.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Make sure '' 'App Templates' '' section is enabled under '' 'Client Area Features'.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:VT_19_19.png]]
 +
|}
 +
====Advanced Configuration====
 +
<!---
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|'''This section is still under construction. We apologize for any inconvenience. If you need more details about the App Templates configuration, please [https://www.modulesgarden.com/support/ticket contact] our support team directly.'''
 +
More details regarding manually creating and editing templates will be included soon.
 +
|}
 +
--->
 +
{|
 +
|style="padding: 0px 0px 5px 15px;"|App templates allow for even more in-depth management with the ability to create and edit custom applications.
 +
See the examples below to learn about the most important options.
 +
|}
 +
=====Adding Applications Manually=====
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Manually add a single application, instead of loading all your applications at once.<br/>
 +
1. Navigate to '' 'App Templates' '' → '' 'Applications' '' and click on '' 'Create'.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_14_1.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 5px 15px;"|2. Download the list of applications from you panel's API.
 +
See the official  [https://www.vultr.com/api/#tag/application/operation/list-applications official Vultr documentation] too learn how.<br/>
 +
Make sure to include your API Key, the request looks like this:
 +
curl "https://api.vultr.com/v2/applications" \
 +
  -X GET \
 +
  -H "Authorization: Bearer ${VULTR_API_KEY}"
 +
Example result:
 +
 
 +
{
 +
"applications": [
 +
{
 +
"id": 1,
 +
"name": "LEMP",
 +
"short_name": "lemp",
 +
"deploy_name": "LEMP on CentOS 6 x64",
 +
"type": "one-click",
 +
"vendor": "vultr",
 +
"image_id": ""
 +
}
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|3. In the '' 'Name' '' field we recommend including the value of the '' '"name": "$name"' '' field.
 +
For example '' 'LEMP' '' from:
 +
"name": "LEMP",
 +
'''''Note:''' If you include a '' 'name' '' setting detail (see step 4) with the name from the request as its value, you can safely rename the application to something else here.''
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_14_2.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|4. Edit your newly added application, and under '' 'Settings Details' ''  edit/create application details outputted by the panel's API.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_14_3.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Carefully look at the API output and fill out the '' 'Name' '' and '' 'Default Value' '' fields with you application details.
 +
In our case it is:
 +
"id": 1,
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_14_5.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|Add the remaining settings following the same pattern of filling the '' 'Name' '' and '' 'Default Value' '' fields.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_14_6.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|The application will be available on the list and ready to be included in a group.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:VT_19_14_4.png]]
 +
|}
 +
 
 +
=====Including Cloud-Init / User-Data Scripts=====
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Enter the user data to run common configuration tasks when the instance starts. You can run cloud-init directives or shell scripts for Linux images. You may use smarty variables, e.g. ''{$password}.''<br/>  '''''Note:''' Please refer to the following article to find a '''list of supported [https://developers.whmcs.com/provisioning-modules/module-parameters/ module parameters]''' and their descriptions.''<br/>
 +
If an application supports scripts, the responsible setting will always be added automatically.<br/>
 +
To include a script, edit the setting by clicking on the '' 'Edit' '' button next to it.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_14_7.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|See the list below to learn how to set up the setting.
 +
*'''Name''' - do not change this value, this is the setting identifier.
 +
*'''Field Type''' - if the '' 'Visibility' '' setting is toggled on, this field decides the type of field, we recommend leaving it as is.
 +
*'''Default Value''' - this is where you include your script. If '' 'Visibility' '' is toggled on, this will be the default value that clients can modify.<br/>'''''Note:''' Use the merge field list on the right for reference.''
 +
*'''Validation''' - optionally, provide [https://laravel.com/docs/11.x/validation#available-validation-rules Laravel validation rules] like '' 'required'.''
 +
*'''Visibility''' - this will allow the client to modify the script before installation.
 +
 
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:VT_19_14_8.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|If the '' 'Visibility' '' toggle is on, the script will be accessible before the installation, if not, the script will just be performed as normal.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:VT_19_14_9.png]]
 
|}
 
|}
  

Revision as of 11:40, 17 April 2025

Contents

About Portainer Docker Containers For WHMCS

Portainer Docker Containers For WHMCS is a powerful tool
  • Addon Module Features:
✔ ffffff
✔ fffffffffff
✔ f
✔ Set Failure Count To Trigger Notification
  • Client Area:
✔ Create Monitoring Checks For Allowed Services Within Specified Limits:
✔ Set Server Monitoring Check Limit
  • General Info:
✔ Multi-Language Support With Custom Translations Tool
✔ Supports PHP 8.4 Back To PHP 8.1
✔ Supports WHMCS V8.13 Back To WHMCS V8.10
✔ Requires ionCube Loader V14 Or Later
✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install and configure Portainer Docker Containers For WHMCS.

We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.
PDC 1.png
2. Extract the package and upload its content into the main WHMCS directory.

The content of the package to upload should look like this.

PDC 2.png
3. When you install Portainer Docker Containers For WHMCS for the first time you have to rename 'license_RENAME.php' file.

The file is located in 'modules/addons/PortainerDockerContainers/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

PDC 3.png
4. In order to configure your license key, you have to edit the previously renamed 'license.php' file.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

PDC 4.png
5. Now, set up the 'storage' folder as recursively writable.

This folder is available at '/yourWHMCS/modules/addons/PortainerDockerContainers/'.

PDC 5.png
5. Now you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Go to 'System Settings' 'Addon Modules'. Afterwards, find 'Portainer Docker Containers' and press the 'Activate' button.

PDC 6.png
6. In the next step, you need to permit access to this module.

To do so, click on the 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

PDC 7.png
8. You have just successfully installed Portainer Docker Containers For WHMCS!

You can access your module under 'Addons' 'Portainer Docker Containers'.
Read the guide provided on the 'Dashboard' or continue with this documentation.

PDC 8.png

Management

Server Monitoring For WHMCS empowers your clients with tools to monitor their services directly from the WHMCS client area.

In this brief guide, we will introduce the module’s capabilities and show you how to make the most of its features.

Module Addon

The module addon is where all of the setup and management take place for the admin.

It allows you to add products to the module, enabling the creation of checks for services associated with those products.
It also features several management tools like the queue, translations tool and module logs.

App Templates

'App Templates' allow you to manage and ultimately provide applications, ISO images, operating systems, and snapshots to your clients.

Prepare templates in the 'Applications' tab and gather them into groups in the 'Groups' tab.
For clients to be able to install templates on their VPS, their product has to include an 'Application Group' and allow 'App Templates' in the client area.

Applications

Read the guide carefully, as it contains crucial information on how to use 'App Templates'.

You can change the settings and have the guide collapsed by default. Clicking on the 'Additional Actions' button, select 'Options' and 'Collapse Guide'.

VT 19 8.png
You can switch between Applications, ISO Images, Operating Systems, and Snapshots by clicking on relevant tabs.
VT 19 9.png
You can use the refresh button to download and later refresh templates from the server.
VT 19 10.png
Once the items are loaded, you can use the action buttons to edit, duplicate or delete them from the list.

You can also use the mass action buttons to manage multiple templates at once.

VT 19 11.png

Groups

With the templates ready, all that is left is to gather them into groups and include said groups into products.

Navigate to 'App Templates' 'Groups' and click on the 'Create' button.

VT 19 15.png
Read the information, then provide the group with:
  • Name
  • Description
  • Items to include

Note: Keep in mind that Vultr includes Windows licenses (Core and Standard) in their Plans and charges a monthly fee for them.
Since this will affect the Plan price, we recommend not including Windows with other systems in one product.

VT 19 16.png
You can use the action button and the mass action function to edit and delete groups.
VT 19 17.png
For the client to take advantage of the application templates, the product module settings have to include the group.

Find the 'App Templates Configuration' section and 'Default Application Group' field.
Include a chosen group for the product.

VT 19 18.png
Make sure 'App Templates' section is enabled under 'Client Area Features'.
VT 19 19.png

Advanced Configuration

App templates allow for even more in-depth management with the ability to create and edit custom applications.

See the examples below to learn about the most important options.

Adding Applications Manually
Manually add a single application, instead of loading all your applications at once.

1. Navigate to 'App Templates' 'Applications' and click on 'Create'.

VT 19 14 1.png
2. Download the list of applications from you panel's API.

See the official official Vultr documentation too learn how.
Make sure to include your API Key, the request looks like this:

curl "https://api.vultr.com/v2/applications" \
 -X GET \
 -H "Authorization: Bearer ${VULTR_API_KEY}"

Example result:

{
"applications": [
{
"id": 1,
"name": "LEMP",
"short_name": "lemp",
"deploy_name": "LEMP on CentOS 6 x64",
"type": "one-click",
"vendor": "vultr",
"image_id": ""
}
3. In the 'Name' field we recommend including the value of the '"name": "$name"' field.

For example 'LEMP' from:

"name": "LEMP",

Note: If you include a 'name' setting detail (see step 4) with the name from the request as its value, you can safely rename the application to something else here.

VT 19 14 2.png
4. Edit your newly added application, and under 'Settings Details' edit/create application details outputted by the panel's API.
VT 19 14 3.png
Carefully look at the API output and fill out the 'Name' and 'Default Value' fields with you application details.

In our case it is:

"id": 1,
VT 19 14 5.png
Add the remaining settings following the same pattern of filling the 'Name' and 'Default Value' fields.
VT 19 14 6.png
The application will be available on the list and ready to be included in a group.
VT 19 14 4.png
Including Cloud-Init / User-Data Scripts
Enter the user data to run common configuration tasks when the instance starts. You can run cloud-init directives or shell scripts for Linux images. You may use smarty variables, e.g. {$password}.
Note: Please refer to the following article to find a list of supported module parameters and their descriptions.

If an application supports scripts, the responsible setting will always be added automatically.
To include a script, edit the setting by clicking on the 'Edit' button next to it.

VT 19 14 7.png
See the list below to learn how to set up the setting.
  • Name - do not change this value, this is the setting identifier.
  • Field Type - if the 'Visibility' setting is toggled on, this field decides the type of field, we recommend leaving it as is.
  • Default Value - this is where you include your script. If 'Visibility' is toggled on, this will be the default value that clients can modify.
    Note: Use the merge field list on the right for reference.
  • Validation - optionally, provide Laravel validation rules like 'required'.
  • Visibility - this will allow the client to modify the script before installation.
VT 19 14 8.png
If the 'Visibility' toggle is on, the script will be accessible before the installation, if not, the script will just be performed as normal.
VT 19 14 9.png

Checks

Once products are added, both admins and clients can create checks for services.

To see how clients can add and monitor checks for their services see the Client Area section.
To add checks as an admin, navigate to the 'Checks' section of the module and click on the 'Create Check' button.

SM 17.png
Provide the required fields:
  • Name - provide a name for the check.
  • Status - select the initial status of the check, this can be changed later.
  • Verification Interval - decide how often the check should be performed (in minutes).
  • Failure Count for Notification - indicates how many checks need to fail before a notification is sent.
  • Notifications Delay - set the notification delay, in minutes, for sending notifications when checks fail.
  • Monitored Service - select the service that will be checked.
  • Type of Performed Check - pick the check type.
    • cURL Check - an HTTP GET request is sent to a server to retrieve data and check its availability.
      • Request URL - provide a URL that will return a code upon a GET request.
      • Response Code - include the expected HTTP response code.
    • ICMP Ping Check - an ICMP ping is sent to a specific IP address to test if the server is reachable.
      • IP Address - provide the IP address for the check.
    • Socket Ping Check - a connection attempt is made to a specific IP address and port to check if the service is running and accessible.
      Important: This ping type requires specific configuration, see the Tips section for details.
      • IP Address - provide the IP address for the check.
    • Port Connect - a connection attempt is made to a specific IP address and port using the TCP protocol to verify if the service on the specified port is running and accessible.
      • Allow Custom IP Address - allow the client to enter a custom IP address instead of selecting from assigned ones.
  • Notification Type - select the notification type.
    • Email Notification - email messages will be sent out after the threshold for failed checks is exceeded.
      • Email Template for Failed Checks - decide which email template will be used when the failed check threshold is exceeded.
        The default email template is named 'Server Monitoring - failed checks alert', it includes merge fields and can be freely edited.
      • Email Template for Service Recovery - decide which email template will be used when the service has recovered.
        The default email template is named 'Server Monitoring - service unreachable', it includes merge fields and can be freely edited.
      • Notification Recipients - select where to send the notification.
    • SMS Notification - enable SMS notifications to keep clients informed of monitoring events.
      Note: SMS notifications require SMS Center For WHMCS.
      • Message Template for Failed Checks - choose the SMS template used to notify clients when a check fails.
      • Message Template for Service Recovery - choose the SMS template used to notify clients when a service recovers following downtime.
      • API Execution Admin - select the admin account that will execute API requests.
      • SMS Recipients - Provide the phone numbers to which the notification will be sent. Use a valid international format, such as +XX XXXXXXXXXX or +XX.XXXXXXXXX, where 'XX' is the country code.
SM 18.png
Once checks are added, you can turn them off and on with the 'Status' toggle.
SM 19.png
Click the 'Show Logs' button to display logs related to the specific check.
SM 20.png
The logs will include:
  • The result of the check
  • Its message
  • Its date

Note that clients will not be able to see messages when checking logs in the client area.

SM 21.png
Use the action buttons to edit or delete checks as needed.
SM 22.png
The mass action function can be used to delete multiple checks at once.
SM 23.png

Queue

The "Queue" tool helps you track and manage the tasks created by the module.

It allows you to view and interact with task details, including task IDs, statuses, and related items.
You can filter tasks, execute actions like deleting or running tasks, and even use mass actions for bulk operations.
For detailed guidance on using this tool, please refer to the dedicated article available here.

SM Q.png

Translations

Customizing language files is now extremely easy with the "Translations" tool that is now available directly in the addon.
Its user-friendly design makes managing various language file tweaks a smooth and efficient process. Prepare translations for the original English files with this handy built-in tool.

For specific instructions on how to use this tool please refer to its dedicated article, you will find it here.

SM T.png

Logs

The "Logs" tool makes monitoring and managing module activity records simple and efficient. It provides options to categorize, filter, and view detailed entries, giving you control over the logs.
Features like bulk deletion, rule-based deletion, and export options make it easy to organize and maintain your logs.

For detailed guidance on using this tool, check its dedicated article, which is available here.

SM L.png

Dashboard

The 'Dashboard' provides information and statistics related to the functions of the module.

At the top, you will find a condensed setup guide, presenting the same information as this documentation.

SM 9.png
After familiarizing yourself with the guide, you can opt to hide it under 'Additional Actions' 'Settings'.
SM 9 1.png
Monitor total check successes and failures over time with the line graph.
SM 10.png
All check successes and failures are counted across different categories:
  • Check Results from the Last 24 Hours
  • Check Results from the Last 7 Days
  • Check Results from the Last 30 Days
  • Total Check Results
SM 11.png
The most recent checks are listed in the 'Recently Performed Checks' table, the information includes:
  • Check ID
  • Check Name
  • Related Service
  • Check Type
  • Status
SM 12.png

Client Area

Clients will be able to take advantage of Server Monitoring For WHMCS too, as long as they own one of the products you have configured.

The basic client area integration allows them to create and monitor checks for their service, within restrictions opposed by the admin.
To add a new check, click on the 'Create Check' button.

SM 24.png
Fill out the necessary fields:
  • Name - provide a name for the check.
  • Status - set the initial status of the check, it can be toggled off and on later as well.
  • Verification Interval - set how often the check should be performed (in minutes).
  • Failure Count for Notification - set how many checks with the failed verification are needed to send a notification.
  • Type of Performed Check - select the type of the check.
  • IP Address - select/provide an IP address to be checked.
  • Notification Type - select the type of the notification.
  • Notification Recipients - select where the notification should be sent.
SM 25.png
Once the check is added, you can toggle it on/off as needed with the 'Status' toggle.
SM 26.png
You can display logs for the specific check by clicking on the 'Show Logs' button.
SM 27.png
The logs only include results of the selected check, as opposed to all logs in the table below.
SM 28.png
Use the action buttons to edit or delete created checks whenever you need to.

Consider disabling a check with the 'Status' toggle before deleting it for good.

SM 29.png
The 'Server Monitoring Logs' list check history of every check related to the service in a single table including:
  • Check Name
  • Check Type
  • Check Result
  • Check Date
SM 30.png
A graph with check results over time will be drawn for the service as well, provided the function has been enabled.
SM 30 1.png


Tips

1. If you plan on using the 'Socket Ping Check' check type, make sure that queue executor cron has admin permissions.
You can do this by running it from an account with sudo permissions or adding 'sudo' before the cron job line like this:
 sudo php -q /your_whmcs/modules/addons/ServerMonitoring/cron/cron.php checks:run 
2. Use the Configurable Option below to enable module features in the client area for the selected service. This option can also be utilized to include additional charges if needed.
Note: Products still have to be added in the module addon.
serverMonitoring|Server Monitoring Tool
3. Use the Configurable Option below to allow clients to select their preferred checks limit during the ordering process. You may also configure pricing based on the selected limit.
serverMonitoringChecksLimit|Checks Limit

Update Instructions

An essential guidance through the process of updating the module is offered here.

Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.
Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.

Upgrade Guide

Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?
There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.

Opt for the Open Source version of your Server Monitoring For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.

Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Navigation
WHMCS Modules
WHMCS Widgets
Tools And Applications
Translations
General
FAQ
Community
Portainer Docker Containers For WHMCS