How to add custom domains to non-production environments

Adding a custom domain to a non-production environment (i.e. staging and development) is currently a feature available to all flex plan holders.

If you are a legacy or fixed customer, the feature may need to be activated per project by our team of Support Engineers - please submit a ticket to request activation.

Once activated, you can set up custom non-production domains through the use of a set of Upsun CLI commands.

To add a custom domain, follow the steps:

1. Make sure your DNS record points to the target of your non-production environment.

   Target:

   upsun environment:info edge_hostname --environment <environment_id>

2. Add domain:

   upsun domain:add <new_custom_domain> --environment <environment_id> --replace <production_custom_domain>

   Example:

   upsun domain:add staging.mysite.com --environment staging --replace mysite.com

You can read more about this topic in our public documentation.