All Collections
Get Started
Add-ons
Setting up your custom domain
Setting up your custom domain

We explain how the process works and what is needed to activate this feature in your account.

Diego Gutierrez avatar
Written by Diego Gutierrez
Updated over a week ago

1. Introduction

As explained above, setting up your own domains is a manual process. It requires an exchange of information between you and our customer care team and you also will need a production account.


2. Process

To add your own domain, navigate to "Domains" in the side menu of your dashboard. From there, click on "Add your own domain," and create a ticket. For the ticket, you will be asked to fill out the following information detailed in this article, depending on your specific use case.

2.1 Providing TLS certificates

api.video requires a valid TLS certificate for every custom domain that you want to use and also your certificate key.

Simply upload the certificates for every custom domain through your ticket.

Find here some domain providers with which you can easily get your certificate


Once you send us this information, we will make the necessary changes on our side and when everything is ready you will have to follow the steps described below.

2.2 Updating DNS records

You need to update your custom domain’s DNS records. Simply add a CNAME for every custom domain that you want to use. Each custom URL should point to api.video’s corresponding CDN.

  • video.mycustomdomain.com CNAMEvod.api.video

  • live.mycustomdomain.com CNAMElive.api.video

  • embed.mycustomdomain.com CNAMEembed.api.video

  • collector.mycustomdomain.com CNAMEcollector.api.video

The steps to update your custom domain’s DNS records are determined by the domain host that you use. Contact your domain host if you are unsure about the specific steps of updating the DNS records.

Depending on your use case, you might need separate domains for video, live, collector, and embed services. This should be done for every custom domain that you want to use.

YOUR USE CASE

CUSTOM DOMAINS NEEDED

Live streaming

live.mycustomdomain.com, embed.mycustomdomain.com, collector.mycustomdomain.com

VOD and Live streaming

video.mycustomdomain.com, live.mycustomdomain.com, embed.mycustomdomain.com,collector.mycustomdomain.com

VOD only

video.mycustomdomain.com , embed.mycustomdomain.com,collector.mycustomdomain.com

VOD using your own custom player

video.mycustomdomain.com

2.3 Start using your new video or live domain

After you have configured your DNS records and provided the corresponding TLS certificates, api.video will enable traffic for each custom domain that you want to use.

This process usually takes a few hours. If you have any questions, feel free to reach out to us!

Did this answer your question?