From b3b1f12e6939c97fc8d9c6a6fe0b6ec485f4f213 Mon Sep 17 00:00:00 2001 From: Jose Diaz-Gonzalez Date: Fri, 29 Jul 2016 02:32:24 -0400 Subject: [PATCH] Clarify documentation surrounding port management for domain and ssl configuration When configuring domains/ssl certificates, the port mappings for an application may be automatically set. This can cause issues for applications which will use non-standard ports - ie. for Dockerfile deploys. [ci skip] --- docs/configuration/domains.md | 2 ++ docs/configuration/ssl.md | 2 ++ 2 files changed, 4 insertions(+) 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.