Title here
Summary here
Offer Nova Experience in cPanel
Nova Experience allows your customers to log in to Nova directly and skip the cPanel interface entirely. This way, you can offer Nova as a standalone product and provide each customer with a cPanel account for web hosting only. Each customer account has its own pool of Nova credits per the package tier you assign.
Nova and Nova for WordPress® are alternative options that give customers access to Nova from the cPanel interface. To compare every option for offering Nova, read our Nova for Partners documentation.
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.
Nova availability may depend on your current cPanel license tier and hosting infrastructure configuration.
Your server must meet the following technical requirements:
- Run cPanel & WHM version 134 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.
Nova Experience cPanel accounts operate in a specialized web hosting mode that focuses on website and app creation rather than traditional hosting management tasks. Ensure your customers understand this distinction when you provide Nova services.
Set up Nova Experience in WHM
After you purchase a Nova license, complete the following steps in WHM:
- Create a Nova Experience feature list, or use the preset feature list.
- Create a Nova Experience package.
- Assign the Nova Experience package to cPanel accounts.
1. Create a Nova Experience feature list
The __default_nova feature list enables all feature requirements for Nova Experience. You can assign this feature list to a package and start offering Nova Experience to your customers.
We strongly recommend that you do not use an existing feature list to provide access to Nova Experience. If you enable the Nova Experience feature in an existing feature list, the users you assigned to it will lose access to the cPanel interface.
Nova (Meridian) and Nova for WordPress (Meridian) are separate features that allow customers to access Nova from the cPanel Meridian interface. For more information, read our Nova for Partners documentation.
To create a new Nova Experience feature list, perform the following steps:
- Go to WHM’s Feature Manager interface (WHM » Home » Packages » Feature Manager).
- Click Add a new feature list to create a feature list.
- Select the Nova Experience feature. The system automatically enables all required features for Nova Experience.
- Select any optional features you want to provide to Nova Experience users.
- Click Save.
Required features
Nova Experience requires the following features. You can use the corresponding parameter value of each feature to run WHM API 1 functions in WHM.
| Feature Name | Parameter | Description |
|---|---|---|
| Addon Domains | addondomains | Allows customers to manage multiple domains through the Nova Experience interface. |
| API Tokens | apitokens | Enables secure communication between Nova and your server. |
| AutoSSL | autossl | Automatically installs and renews SSL certificates for domains. |
| Awstats | awstats | Provides detailed website statistics and analytics. |
| Bandwidth Stats | bandwidth | Displays bandwidth usage statistics and monitoring. |
| Change Language | setlang | Changes the interface language preference. |
| Contact Information | updatecontact | Updates contact information and email addresses. |
| File Manager | filemanager | Enables file access and website content management. |
| Latest Visitors | lastvisits | Shows the most recent visitors to the website. |
| Raw Access Logs | rawlog | Displays raw server access logs. |
| SSL Host Installer | sslinstall | Installs SSL certificates manually. |
| SSL/TLS | sslmanager | Manages SSL/TLS certificates for domains. |
| SSL/TLS Wizard | tls_wizard | Guides users through the SSL/TLS certificate setup process. |
| Subdomains | subdomains | Provides subdomain creation and management capabilities. |
Optional features
You can enable the following features to customize your Nova Experience feature lists in your cPanel & WHM server. Your Nova Experience customers do not interact with these features.
| Feature Name | Parameter | Description |
|---|---|---|
| Apache Handlers | handlers | Configures how the server handles different file types. |
| Dynamic DNS | dynamicdns | Manages DNS settings for domains with dynamic IP addresses. |
| Encryption (PGP/GPG) | pgp | Manages PGP keys for email encryption. |
| Error Log | errlog | Displays website error logs for troubleshooting. |
| IP Blocker | ipdeny | Blocks specific IP addresses from accessing the website. |
| Metrics Editor | statselect | Selects which statistics program to use for the website. |
| MIME Types | mime | Manages MIME type associations for file extensions. |
| ModSecurity Domain Manager | modsecurity | Configures web application firewall rules and settings. |
| Optimize Website | optimizews | Optimizes website performance through compression settings. |
| Redirects | redirects | Creates and manages URL redirects. |
| SSH Access & Terminal | ssh | Manages SSH access and keys. |
| Track DNS | nettools | Provides network diagnostic tools like ping and traceroute. |
| Virus Scanner | clamavconnector_scan | Scans files for viruses and malware using ClamAV®. |
Nova Experience limits access to traditional cPanel functionality. Features outside of this list are not compatible with Nova Experience. They will have no effect on your server or your customers’ accounts.
2. Create a Nova Experience package
To create or update a hosting package for Nova Experience, perform the following steps:
- Navigate to WHM’s Add a Package interface (WHM » Home » Packages » Add a Package).
- In the Package Type section, select Nova Package.
- Enter a name for the package and configure its resources and settings. The Feature List setting shows all feature lists that you have configured for Nova Experience.
- In the Package Extensions section, select Nova and a package tier. For more information on each tier, read our Billing and AI Credits documentation.
- Click Add.
Set domain limits in a package
Customers in paid tiers can create unlimited draft projects. You can control the number of published projects for each package by setting an addon domains limit. This limit determines the number of separate websites and apps customers can create and manage in Nova.
Configure the Max Addon Domains option in the package settings to match your hosting service tiers and business requirements. Customers may want to create multiple websites and apps for different projects or business purposes.
When using addon domains, you must have at least as many subdomains as addon domains, since each addon domain consumes a subdomain. You can also allow more subdomains than addon domains.
3. Assign the Nova Experience package to cPanel accounts
After creating your Nova Experience packages, you can assign them to cPanel accounts using WHM’s Create a New Account interface (WHM » Home » Account Functions » Create a New Account).
- You can only grant access to Nova Experience at the time of account creation.
- You cannot grant access to existing cPanel accounts.
WHM API 1 functions
You can use the following WHM API 1 functions to manage your feature lists, packages, and accounts for Nova Experience. Run each command as the root user on your cPanel & WHM server.
Feature lists
Use the create_featurelist or update_featurelist functions to manage your feature lists. Your request must enable all the features Nova Experience requires, unless they were already enabled.
For example, you can run the following command to create a Nova Experience feature list:
whmapi1 create_featurelist featurelist=nova_experience \
standalone-nova=1 addondomains=1 apitokens=1 autossl=1 awstats=1 \
bandwidth=1 filemanager=1 lastvisits=1 rawlog=1 setlang=1 \
sslinstall=1 sslmanager=1 subdomains=1 tls_wizard=1 updatecontact=1Packages
Use the addpkg, editpkg, and addpkgext functions to manage your Nova packages. You can include the following parameters in your request:
| Parameter | Description |
|---|---|
name | The name of your package. |
featurelist | The Nova Experience feature list with the required dependencies, or the __default_nova feature list. |
_PACKAGE_EXTENSIONS | The extensions you enable for the package. You must set this to 'ai-app-builder'. |
package_type | The package type. You must set this to nova. This parameter defaults to standard. |
AI_APP_BUILDER_TIER | The Nova package tier for the cPanel account. Use free, start, build, grow, or scale. This parameter defaults to free. |
For example, you can run the following command to create a Nova Experience package on the start tier:
whmapi1 addpkg name=nova-start featurelist=__default_nova package_type=nova \
_PACKAGE_EXTENSIONS=ai-app-builder AI_APP_BUILDER_TIER=startcPanel accounts
Use the createacct function and set the plan parameter to the name value for your Nova Experience package.
For example, you can run the following command to create a cPanel account on the nova-start package:
whmapi1 createacct username=user domain=example.com plan=nova-startYou can also use the create_user_session function to generate a one-time login URL that redirects the user to their Nova Experience account.
For example, you can run the following command to create a one-time login URL for the user account:
whmapi1 create_user_session user=user service=cpaneldIntegration guides
Nova Experience supports the following optional integrations:
- Add Nova Experience to Your Customer Portal — Let customers start a Nova project from your own website and arrive in Nova already signed in.
- Use the Nova Experience on cPanel Module in WHMCS — Accept Nova Experience orders and provision cPanel accounts automatically through WHMCS.
- 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.