# Offer Nova Experience in cPanelNova Experience requires a Nova license and a server running cPanel & WHM version 134 or later, with a valid SSL certificate. Setup takes three steps in WHM: create a feature list from the __default_nova preset or a custom list, create a Nova Package carrying the Nova extension and a credit tier, then assign it while creating a cPanel account, the only time it can be assigned. Max Addon Domains caps published projects. WHM API 1 equivalents are create_featurelist, addpkg, addpkgext, and createacct.

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.

{{< callout context="note" icon="outline/info-circle" >}}
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](/en/partners/nova-for-partners/) documentation.
{{< /callout >}}

## Requirements

To get Nova for your hosting company, <a href="https://docs.cpanel.net/manage2/licenses/how-to-purchase-a-nova-license/" target="_blank">purchase a Nova license</a>. Nova functionality will automatically be available on your server about 15 minutes after you purchase the license.

{{< callout context="note" icon="outline/info-circle" >}}
Nova availability may depend on your current cPanel license tier and hosting infrastructure configuration.
{{< /callout >}}

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.

{{< 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 >}}

## Set up Nova Experience in WHM

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

1. [Create a Nova Experience feature list](#create-a-nova-experience-feature-list), or use the preset feature list.
2. [Create a Nova Experience package](#create-a-nova-experience-package).
3. [Assign the Nova Experience package to cPanel accounts](#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.

{{< callout context="caution" icon="outline/alert-triangle" >}}
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](/en/partners/nova-for-partners/) documentation.
{{< /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" rel="noopener noreferrer">_Feature Manager_</a> interface (_WHM >> Home >> Packages >> Feature Manager_).
2. Click _Add a new feature list_ to create a feature list.
3. Select the _Nova Experience_ feature. The system automatically enables all [required features](#required-features) for Nova Experience.
4. Select any [optional features](#optional-features) you want to provide to Nova Experience users.
5. 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](#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®. |

{{< callout context="note" icon="outline/info-circle" >}}
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.
{{< /callout >}}

### 2. Create a Nova Experience package

To create or update a hosting package for Nova Experience, perform the following steps:

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. In the _Package Type_ section, select _Nova Package_.
3. 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.
4. In the _Package Extensions_ section, select _Nova_ and a package tier. For more information on each tier, read our [Billing and AI Credits](/en/welcome/billing-and-ai-credits/) documentation.
5. 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 <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.

## 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 <a href="https://api.docs.cpanel.net/openapi/whm/operation/create_featurelist/" target="_blank" rel="noopener noreferrer">`create_featurelist`</a> or <a href="https://api.docs.cpanel.net/openapi/whm/operation/update_featurelist/" target="_blank" rel="noopener noreferrer">`update_featurelist`</a> 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:

```shell
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=1
```

### Packages

Use the <a href="https://api.docs.cpanel.net/specifications/whm.openapi/hosting-plans/packages-addpkg" target="_blank" rel="noopener noreferrer">`addpkg`</a>, <a href="https://api.docs.cpanel.net/openapi/whm/operation/editpkg/" target="_blank" rel="noopener noreferrer">`editpkg`</a>, and <a href="https://api.docs.cpanel.net/openapi/whm/operation/addpkgext/" target="_blank" rel="noopener noreferrer">`addpkgext`</a> 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:

```shell
whmapi1 addpkg name=nova-start featurelist=__default_nova package_type=nova \
  _PACKAGE_EXTENSIONS=ai-app-builder AI_APP_BUILDER_TIER=start
```

### cPanel accounts

Use the <a href="https://api.docs.cpanel.net/specifications/whm.openapi/account-creation/accounts-createacct" target="_blank" rel="noopener noreferrer">`createacct`</a> 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:

```shell
whmapi1 createacct username=user domain=example.com plan=nova-start
```

You can also use the <a href="https://api.docs.cpanel.net/specifications/whm.openapi/session/session-create_user_session" target="_blank" rel="noopener noreferrer">`create_user_session`</a> 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:

```shell
whmapi1 create_user_session user=user service=cpaneld
```

## Integration guides

Nova Experience supports the following optional integrations:

- **[Add Nova Experience to Your Customer Portal](/en/partners/integration-guides/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](/en/partners/integration-guides/use-the-whmcs-nova-experience-on-cpanel-module/)** — Accept Nova Experience orders and provision cPanel accounts automatically through WHMCS.
- **[Use the Partner Rebuild API](/en/partners/integration-guides/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](/en/partners/nova-partner-dashboard/#customize-your-branding) documentation.