Custom domain

Set a custom domain for each of your service to let users reach them using your brand’s domain. Say, app.your-awesome-site.com.

Here is how you can set it up.

​

Steps

​

1. Add your domain

1. Navigate to the specific environment dashboard (from Environments section)
2. Click on Services tab to see all services
3. In the Service dashboard, navigate to “Custom domain” tab.
4. Enter your new domain and click save.

Clicking “Save” button will give you DNS records to add to your domain DNS settings.

In next step, we will use these DNS records to verify the ownership of your domain and to route traffic from your domain to your environment.

​

2. Verify your domain - Add CNAME records:

In this step you will verify the ownership of your domain by adding the CNAME records you see in above step.

Go to your DNS registrar > DNS Zone and add the given CNAME records.

​

3. Deploy

Once you have added the given CNAME records to your domain’s DNS settings give it a few minutes for the DNS settings to propagate. Then, come back to Service > Custom domain settings page, and click on “Verify and deploy” button.

LocalOps will then

1. configure your service to run on the custom domain you added and
2. auomatically provison a brand new auto-renewing SSL Certificate for the custom domain

You can now reach your service using the new domain.

​

Access current domain

For your code/service to start reading the new domain, trigger a new deployment on your service. Either by pressing “Deploy” button in the service settings section. Or push a new commit on configured branch of the service.

During this deployment, LocalOps fills environment variable LOPS_SVC_HOST with the current active domain.

LOPS_SVC_HOST=app.your-awesome-site.com

You can access this in your app (say NodeJS app) like

console.log(process.env.LOPS_SVC_HOST);