Merge pull request elastic#8446 from elastic/jasper/backport/8375/5.x

[backport] PR elastic#8375 to 5.x

config/kibana.yml

@@ -6,8 +6,9 @@
 # To allow connections from remote users, set this parameter to a non-loopback address.
 # server.host: "localhost"
 
-# Enables you to specify a path to mount Kibana at if you are running behind a proxy. This setting
-# cannot end in a slash.
+# Enables you to specify a path to mount Kibana at if you are running behind a proxy. This only affects
+# the URLs generated by Kibana, your proxy is expected to remove the basePath value before forwarding requests
+# to Kibana. This setting cannot end in a slash.
 # server.basePath: ""
 
 # The maximum payload size in bytes for incoming server requests.

docs/kibana-yml.asciidoc

@@ -2,8 +2,9 @@
 [horizontal]
 `server.port:`:: *Default: 5601* Kibana is served by a back end server. This setting specifies the port to use.
 `server.host:`:: *Default: "localhost"* This setting specifies the host of the back end server.
-`server.basePath:`:: Enables you to specify a path to mount Kibana at if you are running behind a proxy. This setting
-cannot end in a slash (`/`).
+`server.basePath:`:: Enables you to specify a path to mount Kibana at if you are running behind a proxy. This only affects
+ the URLs generated by Kibana, your proxy is expected to remove the basePath value before forwarding requests
+ to Kibana. This setting cannot end in a slash (`/`).
 `server.maxPayloadBytes:`:: *Default: 1048576* The maximum payload size in bytes for incoming server requests.
 `server.name:`:: *Default: "your-hostname"* A human-readable display name that identifies this Kibana instance.
 `elasticsearch.url:`:: *Default: "http://localhost:9200"* The URL of the Elasticsearch instance to use for all your