About

You can add and manage custom domains (alias hostnames) for your Content Hubs or KAF application. You can configure SSL certificates to make sure your site is secure and available through your own domain.

Prerequisite

To setup a new hostname, you need to configure a CNAME DNS record that points your custom domain to your Content Hubs or KAF instance.

For more information, see Set up Alias Hostname for Content Hubs and KAF.

Access the Application Hostnames page

1. Go to your Configuration Management console, and navigate to the Hostnames module. You can also navigate directly: https://{your_site_URL}/admin/config/tab/hostnames.

If you don't see this module in your list, please contact your Kaltura representative to enable it for you.



The 'Hostnames' page opens.



2. Set enabled to 'Yes'.
3. Click Save.
4. At the top of the page, click Navigate to the hostnames page.



The Application Hostnames page opens.



Here you can see all current hostnames for the application.

Add a hostname

1. Click +Add Hostname at the top right of the Application Hostnames page.

The 'Add Hostname' window opens.

2. Click Start.

A new screen displays with a Hostname field.

3. Enter the hostname configured in the DNS CNAME record (for example: video.yourdomain.com)

4. Click Next to continue.

The 'Add Hostname' screen displays.

5. Under SSL certificate type, choose how the SSL certificate will be handled:

• Managed - Kaltura handles the certificate provisioning and automatic renewal, so no manual setup is required.
  • (Optional) Choose a certificate issuer from the dropdown menu (SSL.com - default, Let’s Encrypt, or Google)
• Custom - Choose this option if you want to provide and manage your own SSL certificate.  
  • After choosing 'Custom', additional fields display.

  

  • Enter the following:
  • Custom SSL certificate (PEM format)
  • Private key (PEM format), or select Import from file

  The certificate must:

  • Match the private key
  • Include the exact hostname (CN or SAN)
  • Be valid (not expired or not yet valid)

  Supported certificate types:

  • Single-domain certificates
  • Multi-domain (SAN) certificates

  The following aren't supported:

  • Wildcard certificates
  • Encrypted private keys
  • Non-PEM formats

  If the certificate or key is invalid, inline error messages are displayed.

6. Click Next.

A confirmation screen with the hostname and SSL details displays.

7. Review the details then click Set domain.

The hostname is added with a Pending status. 

The status updates automatically once setup is complete.

Manage hostnames

You can manage each hostname by select actions from the three-dot menu next to the hostname.

Choose the desired action as follows:

Set a main alias

The main alias is the primary domain used for your application.

1. In the Application Hostnames table, locate the desired hostname and click the three dots at the end of the row.
2. Select Set as main alias.

The selected hostname becomes the primary domain for your application. Only one hostname can be set as the main alias at a time.

Delete hostname

1. Select Delete hostname from the three-dot menu. 
A confirmation message displays.
2. Click Delete.
The hostname is removed from the application.

If the hostname is set as the main alias, you must set a different hostname as the main alias before deleting it.