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
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 CNAME
→vod.api.video
live.mycustomdomain.com CNAME
→live.api.video
embed.mycustomdomain.com CNAME
→embed.api.video
collector.mycustomdomain.com CNAME
→collector.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!