Plesk is a multi-functional and multi-level control panel with a wide range a features to easily manage all aspects of a hosting business. With Plesk module for HostBill you can build a complete hosting platform and give your customers the opportunity to manage all aspects of Plesk hosting directly from a single pane of glass billing interface, without the need to login separately.

Activating the module

  1. If the module is included in your HostBill edition you can download it from your client portal.
  2. If the module is not included in your HostBill edition you can purchase it from our marketplace and then download it from the client area.
  3. Once you download the module extract it in the main HostBill directory.
  4. Go to Settings → Modules → Hosting Modules, find and activate Plesk module.

Connecting HostBill with Plesk

  1. Proceed to Settings → Apps → Add new App
  2. From Applications list select Plesk
  3. Enter:
    • Name - Name of this connection
    • Hostname
    • IP Address
    • Username
    • Password

      4. Verify entered credentials by clicking Test Connection to check if HostBill can connect
      5. Save Changes

Adding Plesk Cloud Hosting product

  1. In HostBill go to Settings → Products & Services, and Add new order page
  2. From Order Types select Shared Accounts
  3. After creating order page add new product in it, provide its name and Save changes
  4. In product configuration section proceed to Connect with App, select Plesk module and App server created in previous steps.
  5. Proceed to configuration wizard and set your package limit. 
  6. Submit changes, your package is ready.

For more generic product configuration details including price, automation, emails settings refer to Product Configuration article.

Configuring Metered Billing

Plesk module supports metered billing feature. To configure your metered billing package in product configuration in "General" tab select "Metered" under Price. Following variables can be measured and bill automatically:

  • Traffic

  • Subdomains

  • Emails

  • Redirects

  • Mail groups

  • Autoresponders

  • Mailing lists

  • Databases

  • Domains

  • Sites 

Configuring Client Functions   

In Products & Services → Your Order Page → Your Product → Client Functions you can control what features customer will have access to in client portal, by clicking Enable/Disable next to the given option.
Use Edit button to adjust function appearance in the client portal.

For Plesk you can enable the following client functions dedicated to this module: 

  1. Access Apps - access apps through auto-login iframe
  2. Backup Management  
  3. Control Panel Access  
  4. DNS Management  
  5. Database Management
  6. Domain Aliases 
  7. Domain Forwarding  
  8. Email Management  
  9. FTP Management 
  10. File Manager - access filemanager through auto-login iframe
  11. Manage DBs - access database management through auto-login iframe
  12. Sub-domain Management 

Note about Plesk Obsidian

Please note

Since Plesk Obsidian release some of client functions listed above may not function properly due to Plesk sending too strict CORS headers after SSO made from HostBill.

To solve this:

  • login to your Plesk Obsidian installation using SSH
  • Edit /usr/local/psa/admin/conf/panel.ini
  • Append following lines:
sameOriginOnly = false
sameSiteCookie = "None"
trustedRedirectHosts = your.hostbill.domain

As well as number of standard client functions, such as 

  1. Change Billing Cycle
  2. Change Label
  3. Change Ownership
  4. Edit Forms
  5. Graphs
  6. Login Details
  7. Manual Service Renew
  8. New Direct Link
  9. Related Services
  10. Service Auto Renewal

Accessing account-related variables in email templates

During account creation Plesk module stores additional informations related to accounts in HostBill db. You can access those informations in welcome/automated emails using following variables:

  • Username - {$service.username}
  • Password - {$service.password}
  • Plesk User ID: {$service.extra_details.user_id}
  • Plesk Subscription ID: {$service.extra_details.webspace_id}
  • Web access login: {$service.extra_details.web_login}
  • Web access password: {$service.extra_details.web_password}

Timeout during account creation

If one of the slave Nameservers is unavailable, Plesk waits for a connection, which causes a timeout.