Offer Nova in cPanel Meridian

You can offer Nova or Nova for WordPress® as part of your hosting packages in cPanel Meridian. Your customers reach either one from their own cPanel account, and they keep full access to the cPanel interface.

Nova and Nova for WordPress#

Nova and Nova for WordPress are the two ways your customers can access Nova from cPanel Meridian. You can enable them independently and offer them as part of your hosting packages.

• Nova — Builds any app or site with a fully custom structure and design. It is best suited to custom apps, tools, and websites that need to perform a specific task. Customers can edit and republish their project at any time.
• Nova for WordPress — Builds WordPress sites using the standard WordPress block editor. It is best suited to content sites, blogs, and anything the WordPress plugin ecosystem already serves well. Customers can create new projects with Nova for WordPress and use the WordPress block editor to edit and republish.

Requirements#

To get Nova for your hosting company, purchase a Nova license. Nova functionality will automatically be available on your server about 15 minutes after you purchase the license.

Your server must meet the following technical requirements:

• Run cPanel & WHM version 138 or later.
• Be either a dedicated Nova-targeted cPanel server or host both Nova and cPanel on the same server.
• Have a valid SSL certificate for the server’s hostname.

How customers reach Nova#

Customers can access Nova when they add a website or when they manage their existing websites.

• For new websites — When a customer adds a new website, the Nova or Nova for WordPress options appear during the onboarding flow. They can publish their site or click Back to cPanel to return to cPanel.
• For existing websites — Customers can navigate to the Website Builder section (cPanel » Websites » Manage » Website Builder) and build with Nova or Nova for WordPress.

Set up Nova in WHM#

After you purchase a Nova license, complete the following steps in WHM:

1. Create a Nova feature list.
2. Create a Nova package.
3. Assign the Nova package to cPanel accounts.

Create a Nova feature list#

To create a new feature list for Nova or Nova for WordPress, perform the following steps:

1. Go to WHM’s Feature Manager interface (WHM » Home » Packages » Feature Manager).
2. Click Add a new feature list to create a feature list, or select an existing one and click Edit.
3. Select Nova (Meridian), Nova for WordPress (Meridian), or both.
4. Select the required features for Nova or Nova for WordPress.
5. Click Save.

Required features#

Nova and Nova for WordPress require the following features:

Create a Nova package#

To create or update a hosting package for Nova on cPanel Meridian, perform the following steps:

1. Navigate to WHM’s Add a Package interface (WHM » Home » Packages » Add a Package).
2. In the Package Type section, select Standard Package.
3. Type a name for the package and configure its resources and settings.
   • You must set cPanel Theme to meridian. The classic cPanel Jupiter theme does not have access to Nova.
   • The Feature List setting shows all feature lists that you have configured for Nova and Nova for WordPress.
4. In the Package Extensions section, select Nova and a package tier. For more information on each tier, read our Billing and AI Credits documentation.
5. Click Add.

Set domain limits in a package#

Domain limits work the same way for every Nova deployment on cPanel & WHM. Configure the Max Addon Domains option in the package settings to control how many projects each customer can publish. For more information, read our Offer Nova Experience in cPanel documentation.

Shared credit pool#

Nova and Nova for WordPress share the same credit pool. Therefore, if a customer is on a package that includes both, their usage in Nova or Nova for WordPress draws equally from the credits in their package tier.

Customers can use their Nova and Nova for WordPress credits in any combination. For example, a customer on a Start package (15 credits) could use 5 credits on Nova and 10 credits on Nova for WordPress sites, or any other combination.

For more information on Nova package tiers, read our Billing and AI Credits documentation.

Assign the Nova package to cPanel accounts#

After creating your Nova and Nova for WordPress packages, you can assign them to new or existing cPanel accounts:

• For new accounts, use WHM API 1’s Create a New Account interface (WHM » Home » Account Functions » Create a New Account).
• For existing accounts, use WHM’s Upgrade/Downgrade an Account interface (WHM » Home » Account Functions » Upgrade/Downgrade an Account).

WHM API 1 functions#

You can use the following WHM API 1 functions to manage your feature lists, packages, and cPanel accounts for Nova on cPanel Meridian. Run each command as the root user on your cPanel & WHM server.

Feature lists#

Use WHM API 1’s create_featurelist or update_featurelist functions to manage your feature lists. Your request must enable all the features Nova or Nova for WordPress requires, unless they were already enabled.

For example, you can run the following command to create a Nova feature list:

whmapi1 create_featurelist featurelist=nova_meridian \
  nova=1 addondomains=1 apitokens=1 mysql=1 redirects=1 subdomains=1

To create a Nova for WordPress feature list, run the following command:

whmapi1 create_featurelist featurelist=nova_wordpress \
  nova-wordpress=1 addondomains=1 apitokens=1 mysql=1 redirects=1 \
  subdomains=1 wp-toolkit=1

Packages#

Use the addpkg, editpkg, and addpkgext functions to manage your Nova packages. You can include the following parameters in your request:

For example, you can run the following command to create a Nova package on the start tier:

whmapi1 addpkg name=nova-meridian-start featurelist=nova_meridian \
  cpmod=meridian _PACKAGE_EXTENSIONS=ai-app-builder AI_APP_BUILDER_TIER=start

cPanel accounts#

Use the createacct and modifyacct functions to manage your customers’ access to Nova on cPanel Meridian.

• You must set the plan parameter to the name of your Nova or Nova for WordPress package.
• You must set the cpmod parameter to meridian.

For example, you can run the following command to create a cPanel account on the nova-meridian-start package:

whmapi1 createacct username=user domain=example.com \
  plan=nova-meridian-start cpmod=meridian

Integration guides#

Nova on cPanel Meridian supports the following optional integration:

• Use the Partner Rebuild API — Let customers submit an existing website URL and have Nova recreate the site.

To replace WebPros branding with your own or to use a custom domain, read our Nova Partner Dashboard documentation.