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]
This commit is contained in:
Jose Diaz-Gonzalez committed 2016-07-29 02:32:32 -04:00
1 parent 372802f834
commit b3b1f12e69
2 files changed
+4

No files matched your search

+2
View File
@@ -12,6 +12,8 @@ domains:remove <app> DOMAIN # Remove a domain from app
domains:set-global <domain> # Set global domain name domains:set-global <domain> # 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 ## Customizing hostnames
Applications typically have the following structure for their hostname: Applications typically have the following structure for their hostname:
+2
View File
@@ -17,6 +17,8 @@ certs:update <app> CRT KEY # Update an SSL Endpoint on an app. Can
dokku nginx:import-ssl <app> < certs.tar dokku nginx:import-ssl <app> < 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 ## 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. 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.