Setting the hostname for links in generated emails

Edge for Private Cloud v4.19.01

Edge automatically sends emails in response to certain events as described in Customizing Edge email templates.

Many of these emails contain a link. For example, when a new user is added to an organization, the Edge UI sends the user an email containing a login URL in the form:

https://domain/login

The domain is determined automatically by Edge and is typically correct for the organization. However, there is a chance that when the Edge UI is behind a load balancer that the automatically generated domain name is incorrect. If so, you can use the conf_apigee_apigee.emails.hosturl property to explicitly set the domain name portion of the generated URL.

To set the domain:

  1. Open the ui.properties file in an editor. If the file does not exist, create it:
    vi /opt/apigee/customer/application/ui.properties
  2. Set conf_apigee_apigee.emails.hosturl. For example, set conf_apigee_apigee.emails.hosturl as:
    conf_apigee_apigee.emails.hosturl="http://myCo.com"
  3. Save your changes.
  4. Make sure the properties file is owned by the 'apigee' user:
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Restart the Edge UI:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart