Docs: Add notes about running behind a front-end proxy server

Author: joshiste

spring-boot-admin-docs/src/main/asciidoc/client.adoc

@@ -1,8 +1,8 @@
 [[client-applications]]
-== Client applications ==
+== Client Applications ==
 
 [[show-version-in-application-list]]
-=== Show version in application list ===
+=== Show Version in Application List ===
 
 For *Spring Boot* applications the easiest way to show the version, is to use the `build-info` goal from the `spring-boot-maven-plugin`, which generates the `META-INF/build-info.properties`. See also the http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#howto-build-info[Spring Boot Reference Guide].
 
@@ -29,7 +29,7 @@ For *non-Spring Boot* applications you can either add a `version` or `build.vers
 ----
 
 [[jmx-bean-management]]
-=== JMX-bean management ===
+=== JMX-Bean Management ===
 
 To interact with JMX-beans in the admin UI you have to include https://jolokia.org/[Jolokia] in your application. As Jolokia is servlet based there is no support for reactive applications.
 In case you are using the `spring-boot-admin-starter-client` it will be pulled in for you, if not add Jolokia to your dependencies:
@@ -44,7 +44,7 @@ In case you are using the `spring-boot-admin-starter-client` it will be pulled i
 ----
 
 [[logfile]]
-=== Logfile viewer ===
+=== Logfile Viewer ===
 
 By default the logfile is not accessible via actuator endpoints and therefore not visible in Spring Boot Admin.
 In order to enable the logfile actuator endpoint you need to configure Spring Boot to write a logfile, either by setting
@@ -63,7 +63,7 @@ logging.pattern.file=%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(%5p) %clr(${P
 <2> File log pattern using ANSI colors.
 
 [[show-instance-tags]]
-=== Show tags per instance ===
+=== Show Tags per Instance ===
 
 `Tags` are a way to add visual markers per instanace, they will appear in the application list as well as in the instance view.
 By default no tags are added to instances, and it's up to the client to specify the desired tags by adding the information to the metadata or info endpoint.

spring-boot-admin-docs/src/main/asciidoc/getting-started.adoc

@@ -41,7 +41,7 @@ NOTE: If you want to setup the Spring Boot Admin Server via war-deployment in a
 See also the {github-src}/spring-boot-admin-samples/spring-boot-admin-sample-servlet/[spring-boot-admin-sample-servlet] project, which also adds security.
 
 [[register-client-applications]]
-=== Registering client applications ===
+=== Registering Client Applications ===
 
 To register your application at the SBA Server, you can either include the SBA Client or use http://projects.spring.io/spring-cloud/spring-cloud.html[Spring Cloud Discovery] (e.g. Eureka, Consul, ...). There is also a <<spring-cloud-discovery-static-config,simple option using a static configuration on the SBA Server side>>.
 

spring-boot-admin-docs/src/main/asciidoc/server-discovery.adoc

@@ -6,7 +6,7 @@ The Spring Boot Admin Server can use Spring Clouds `DiscoveryClient` to discover
 TIP: Spring Boot Admin will only update the info and available endpoints when a application changes status or when the registration changes. If you want to trigger an update with every new deployment, you can add a key value pair that changes with every restart (e.g. `eureka.instance.metadata-map.startup: ${random.int}`).
 
 [[spring-cloud-discovery-static-config]]
-==== SimpleDiscoveryClient configuration ====
+==== Static Configuration using SimpleDiscoveryClient ====
 
 Spring Cloud provides a `SimpleDiscoveryClient`. It allows you to specify client applications via static configuration:
 

spring-boot-admin-docs/src/main/asciidoc/server-notifications.adoc

@@ -2,7 +2,7 @@
 
 
 [[reminder-notifications]]
-==== Reminder notifications ====
+==== Reminder Notifications ====
 The `RemindingNotifier` sends reminders for down/offline applications, it delegates the sending of notifications to another notifier.
 
 By default a reminder is triggered when a registered application changes to `DOWN` or `OFFLINE`. You can alter this behaviour via `setReminderStatuses()`. The reminder ends when either the status changes to a non-triggering status or the regarding application gets deregistered.
@@ -32,7 +32,7 @@ public class NotifierConfiguration {
 
 
 [[filtering-notifications]]
-==== Filtering notifications ====
+==== Filtering Notifications ====
 The `FilteringNotifier` allows you to filter certain notification based on rules you can add/remove at runtime. It delegates the sending of notifications to another notifier.
 
 If you add a `FilteringNotifier` to your `ApplicationContext` a RESTful interface on `notifications/filter` gets available.
@@ -51,7 +51,7 @@ TIP: This example combines the reminding and filtering notifiers. This allows yo
 
 
 [[mail-notifications]]
-==== Mail notifications ====
+==== Mail Notifications ====
 
 Mail notifications will be delivered as HTML emails rendered using https://www.thymeleaf.org/[Thymeleaf] templates.
 To enable Mail notifications, configure a `JavaMailSender` using `spring-boot-starter-mail` and set a recipient.
@@ -118,7 +118,7 @@ [email protected]
 |===
 
 [[pagerduty-notifications]]
-==== PagerDuty notifications ====
+==== PagerDuty Notifications ====
 To enable https://www.pagerduty.com/[PagerDuty] notifications you just have to add a generic service to your PagerDuty-account and set `spring.boot.admin.notify.pagerduty.service-key` to the service-key you received.
 
 .PagerDuty notifications configuration options
@@ -156,7 +156,7 @@ To enable https://www.pagerduty.com/[PagerDuty] notifications you just have to a
 
 
 [[opsgenie-notifications]]
-==== OpsGenie notifications ====
+==== OpsGenie Notifications ====
 To enable https://www.opsgenie.com/[OpsGenie] notifications you just have to add a new JSON Rest API integration to your OpsGenie account and set `spring.boot.admin.notify.opsgenie.api-key` to the apiKey you received.
 
 .OpsGenie notifications configuration options
@@ -206,7 +206,7 @@ To enable https://www.opsgenie.com/[OpsGenie] notifications you just have to add
 
 
 [[hipchat-notifications]]
-==== Hipchat notifications ====
+==== Hipchat Notifications ====
 To enable https://www.hipchat.com/[Hipchat] notifications you need to create an API token on your Hipchat account and set the appropriate configuration properties.
 
 .Hipchat notifications configuration options
@@ -245,7 +245,7 @@ To enable https://www.hipchat.com/[Hipchat] notifications you need to create an
 
 
 [[slack-notifications]]
-==== Slack notifications ====
+==== Slack Notifications ====
 To enable https://slack.com/[Slack] notifications you need to add a incoming Webhook under custom integrations on your Slack
 account and configure it appropriately.
 
@@ -285,7 +285,7 @@ account and configure it appropriately.
 
 
 [[letschat-notifications]]
-==== Let's Chat notifications ====
+==== Let's Chat Notifications ====
 To enable https://sdelements.github.io/lets-chat/[Let's Chat] notifications you need to add the host url and add the API token and username from Let's Chat
 
 .Let's Chat notifications configuration options
@@ -324,7 +324,7 @@ To enable https://sdelements.github.io/lets-chat/[Let's Chat] notifications you
 
 
 [[ms-teams-notifications]]
-==== Microsoft Teams notifications ====
+==== Microsoft Teams Notifications ====
 To enable Microsoft Teams notifications you need to setup a connector webhook url and set the appropriate configuration property.
 
 .Microsoft Teams notifications configuration options
@@ -346,7 +346,7 @@ To enable Microsoft Teams notifications you need to setup a connector webhook ur
 
 
 [[telegram-notifications]]
-==== Telegram notifications ====
+==== Telegram Notifications ====
 To enable https://telegram.org/[Telegram] notifications you need to create and authorize a telegram bot and set the appropriate configuration properties for auth-token and chat-id.
 
 .Telegram notifications configuration options
@@ -380,7 +380,7 @@ To enable https://telegram.org/[Telegram] notifications you need to create and a
 
 
 [[discord-notifications]]
-==== Discord notifications ====
+==== Discord Notifications ====
 To enable Discord notifications you need to create a webhook and set the appropriate configuration property.
 
 .Discord notifications configuration options

spring-boot-admin-docs/src/main/asciidoc/server.adoc

@@ -1,7 +1,12 @@
 [[spring-boot-admin-server]]
 == Spring Boot Admin Server ==
 
-.Spring Boot Admin Server configuration options
+=== Running Behind a Front-end Proxy Server ===
+
+In case the Spring Boot Admin server is running behind a reverse proxy, it may be requried to configure the public url where the server is reachable via (`spring.boot.admin.ui.public-url`).
+In addition when the reverse proxy terminates the https connection, it may be necessary to configure `server.use-forward-headers=true` (also see https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#howto-use-tomcat-behind-a-proxy-server[Spring Boot Reference Guide]).
+
+=== Configuration Options ===
 |===
 | Property name |Description |Default value