Repository Custom Domains

Using custom domains in Binara repositories represents the easiest way to get Branded Distribution.

By default, all repositories have a subdomain at r.binara.deployport.io which is the preferred endpoint for all your packages.

You can override the preferred domain for a repository if you register a custom domain.

Custom domains are powered by VIA hostnames, Deployport’s domain management service that handles the edge network with free automatic HTTPS certificates.

Overview

Custom domains for Binara repositories require three steps:

1. Register a hostname in VIA
2. Add the domain to the repo - this effectively creates a binding so VIA serves the repository as the source of resources for your domain.
3. Promote the domain - making it the default for all import instructions.

Adding and Promoting Custom Domains

Register the domain in your repo:

deployport binara repo domains add <myrepo> <mydomain>

After adding your custom domain, the built-in shared domain for Binara is still used. We recommend making your domain the preferred domain:

deployport binara repositories domains promote <repository> <hostname>

That’s it. If you need help debugging the state of your hostname in your registrar, please refer to the VIA guide.