Skip to content

Using a custom domain

Cyril Rohr edited this page Sep 20, 2024 · 2 revisions

By default, pullpreview instances will use a domain name such as pr15-my-beautiful-code-1-2-3-4.my.pullpreview.com domain.

If you wish to use a custom domain instead (e.g. pr15-my-beautiful-code-1-2-3-4.pullpreview.domain.com), you can do so by:

  • assuming you own domain.com and want previews to be under <ENV-NAME>.preview.domain.com, add a record in your DNS zone so that preview.domain.com is a NS record for xip.preview.run.
  • add the dns [input] parameter in your workflow file to indicate the domain you want to use:
with:
  dns: preview.domain.com

That's it!

Clone this wiki locally