diff --git a/docs/configuration/domains.md b/docs/configuration/domains.md index 9c83b64c4..de066357c 100644 --- a/docs/configuration/domains.md +++ b/docs/configuration/domains.md @@ -12,6 +12,8 @@ domains:remove DOMAIN # Remove a domain from app domains:set-global # Set global domain name ``` +> Adding a domain before deploying an application will result in port mappings being set. This may cause issues for applications that use non-standard ports, as those will not be automatically detected. Please refer to the [proxy documentation](/dokku/advanced-usage/proxy-management/) for information as to how to reconfigure the mappings. + ## Customizing hostnames Applications typically have the following structure for their hostname: diff --git a/docs/configuration/ssl.md b/docs/configuration/ssl.md index 9a5cfc18c..fc354f92d 100644 --- a/docs/configuration/ssl.md +++ b/docs/configuration/ssl.md @@ -17,6 +17,8 @@ certs:update CRT KEY # Update an SSL Endpoint on an app. Can dokku nginx:import-ssl < certs.tar ``` +> Adding an ssl certificate before deploying an application will result in port mappings being updated. This may cause issues for applications that use non-standard ports, as those may not be automatically detected. Please refer to the [proxy documentation](/dokku/advanced-usage/proxy-management/) for information as to how to reconfigure the mappings. + ## Per-application certificate management Dokku provides built-in support for managing SSL certificates on a per-application basis. SSL is managed via nginx outside of application containers, and as such can be updated on-the-fly without rebuilding containers. At this time, applications only support a single SSL certificate at a time. To support multiple domains for a single application, wildcard certificate usage is encouraged.