# Set Up Nova Experience in WHMConfigure Nova Experience in WHM by using the preset __default_nova feature list (or a custom feature list with the required apitokens, addondomains, subdomains, and filemanager dependencies), then create a Nova Experience package (WHM > Packages > Add a Package > Package Type: Nova Package) with a client area login URL and upsell URL. Assign the package to cPanel accounts at account creation time only — existing accounts cannot be upgraded to Nova Experience. Configure Max Addon Domains per package to control how many websites/apps each customer can host.

cPanel accounts created with Nova work in a special web hosting mode that makes it easy to create websites without using the cPanel interface. Customers use Nova Experience to build a website or app, and the cPanel server hosts the finished site so others can view it online. When customers finish building a site or app in Nova Experience, it publishes the completed version directly to the Nova Experience cPanel account.

Before your customers can use Nova's AI-powered creation tools, you **must** set up Nova Experience in WHM.

## Set up Nova Experience in WHM

To start offering Nova Experience to your customers, complete the following configuration steps in WHM:

1. [Create a feature list that meets Nova's requirements](#creating-a-nova-feature-list), or use the preset feature list.
2. [Create a Nova Experience hosting package.](#creating-a-nova-hosting-package)
3. [Assign the Nova Experience package to cPanel accounts.](#setting-up-cpanel-users)

## Creating a Nova Experience feature list

cPanel & WHM provides a preset feature list, `__default_nova`, that enables the minimum requirements for Nova Experience. You can use the `__default_nova` feature list to create new accounts or create and use custom Nova-enabled feature lists.

{{< callout context="danger" icon="outline/alert-octagon" >}}
We **strongly** recommend that you do not use an existing feature list to add access to Nova Experience.
- A Nova Experience feature list disables access to other parts of the cPanel interface. cPanel accounts created for this feature list run in a special web hosting-**only** mode and do **not** have access to the standard cPanel interface.
- If you update a feature list for existing cPanel accounts, they will lose access to the cPanel interface.
{{< /callout >}}

To create a new Nova Experience feature list, perform the following steps:

1. Go to WHM's _<a href="https://docs.cpanel.net/whm/packages/feature-manager/" target="_blank">Feature Manager</a>_ interface (_WHM >> Home >> Packages >> Feature Manager_).
2. Under the _Add a new feature list_ section, enter the name of your feature list in the textbox. Then, click _Add Feature List_. The _Edit Feature List_ interface will appear.
3. Make certain that you select the following [required features](#required-features):
   - _Nova Experience_
   - _API Tokens_
   - _Addon Domains_
   - _Subdomains_
   - _File Manager_
   - _AutoSSL_
   - _Awstats_
4. Select any [additional compatible features](#optional-features) you want to provide to Nova Experience users.
5. Click **Save**.

### Required features

Nova **requires** that you enable specific cPanel features:

| 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. {{< callout context="danger" icon="outline/alert-octagon" >}}
If you disable this feature, the system will automatically disable Nova.
{{< /callout >}} |
| _File Manager_ | `filemanager` | Enables file access and website content management. |
| _Subdomains_ | `subdomains` | Provides subdomain creation and management capabilities. |

### Optional features

{{< callout context="tip" icon="outline/rocket" >}}
Nova Experience accounts operate in a specialized mode with limited access to traditional cPanel functionality. As a result, some cPanel features are **not** compatible with Nova Experience. Make sure that you **only** enable the available features below when adding optional features to a custom Nova Experience feature list.
{{< /callout >}}

You can choose to enable the following optional features in Nova Experience feature lists:

| Feature Name | Parameter | Description |
|--------------|--------------|-----------|
| *Addon Domains* | `addondomains` | Allows customers to manage multiple domains through the Nova Experience interface.   |
| *AutoSSL* | `autossl` | Automatically installs and renews SSL certificates for domains.  |
| *AWStats* | `awstats` | Provides detailed website statistics and analytics. |
| *Bandwidth* | `bandwidth` | Displays bandwidth usage statistics and monitoring. |
| *ClamAV Connector Scan* | `clamavconnector_scan` | Scans files for viruses and malware using ClamAV. |
| *Dynamic DNS* | `dynamicdns` | Manages dynamic DNS settings for domains with changing IP addresses. |
| *Error Log* | `errlog` | Displays website error logs for troubleshooting. |
| *Handlers* | `handlers` | Configures how the server handles different file types. |
| *IP Deny* | `ipdeny` | Blocks specific IP addresses from accessing the website. |
| *Last Visitors* | `lastvisits` | Shows the most recent visitors to the website. |
| *MIME Types* | `mime` | Manages MIME type associations for file extensions. |
| *ModSecurity* | `modsecurity` | Configures web application firewall rules and settings. |
| *Network Tools* | `nettools` | Provides network diagnostic tools like ping and traceroute. |
| *Optimize Website* | `optimizews` | Optimizes website performance through compression settings. |
| *PGP* | `pgp` | Manages PGP keys for email encryption.  |
| *Raw Access Log* | `rawlog` | Displays raw server access logs.  |
| *Redirects* | `redirects` | Creates and manages URL redirects. |
| *Set Language* | `setlang` | Changes the interface language preference. |
| *SSH Access* | `ssh` | Manages SSH access and keys for secure shell connections. |
| *SSL Install* | `sslinstall` | Installs SSL certificates manually. |
| *SSL Manager* | `sslmanager` | Manages SSL/TLS certificates for domains. |
| *Stats Programs* | `statselect` | Selects which statistics program to use for the website. |
| *TLS Wizard* | `tls_wizard` | Guides through TLS/SSL certificate setup process. |
| *Update Contact* | `updatecontact` | Updates contact information and email addresses. |

### Using WHM API 1

You can also use WHM API 1's <a href="https://api.docs.cpanel.net/openapi/whm/operation/create_featurelist/" target="_blank">`create_featurelist`</a> function to create new feature lists and the <a href="https://api.docs.cpanel.net/openapi/whm/operation/update_featurelist/" target="_blank">`update_featurelist`</a> function to modify existing feature lists. Make certain that you use the parameters in the sections above to add the [required](#required-features) and [optional](#optional-features) features for Nova.

For standard cPanel accounts using existing feature lists or new feature lists created on the system with configuration management tools, you **must** disable the `standalone-nova` option in the desired feature list file in the `/var/cpanel/features` directory.

{{< highlight bash >}}
standalone-nova=0
{{< /highlight >}}

For Nova Experience accounts, configure the desired feature list file in the `/var/cpanel/features` directory with the following minimum requirements:

{{< highlight bash >}}
standalone-nova=1
apitokens=1
subdomains=1
addondomains=1
filemanager=1
{{< /highlight >}}

## Creating a Nova Experience hosting package

After choosing your Nova Experience feature list, you must create a hosting package that uses the specialized feature set and configure appropriate limits for Nova functionality.

To create a Nova Experience package:

1. Navigate to WHM's _<a href="https://docs.cpanel.net/whm/packages/add-a-package/" target="_blank" rel="noopener noreferrer">Add a Package</a>_ interface (_WHM >> Home >> Packages >> Add a Package_).
2. Select _Nova Package_ for _Package Type_.
3. In the _Package Name_ textbox, enter the package name.
4. Enter the package and settings details, including disk space, bandwidth, and the package tier.
5. Click _Add_.

### Domain limits

You can control how many addon domains each account can use to host websites. This limit determines the number of separate websites and apps customers can create and manage through the Nova Experience interface.

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 may also allow more subdomains than addon domains if desired.

## Setting up cPanel users

After creating your Nova Experience packages, you can assign them to cPanel accounts using WHM's *<a href="https://docs.cpanel.net/whm/account-functions/create-a-new-account/" target="_blank" rel="noopener noreferrer">Create a New Account</a>* 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.

{{< callout context="tip" icon="outline/rocket" >}}
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.
{{< /callout >}}