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 platform.sh customer, the feature may need to be activated per project by our team of Support Engineers at this time - please submit a ticket and request this 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 here.