Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -238,6 +238,36 @@ by going to: *Management* -> *{fleet}* -> *Settings*. From there you can:
** Specify the location from where agents should download binaries.
** Specify proxy URLs to use for {fleet-server} or {agent} outputs.

[discrete]
[[fleet-server-setup-using-a-load-balancer]]
= {fleet-server} setup using a load balancer

Follow these steps when deploying {fleet-server} behind a load balancer/reverse proxy:

. Create a certificate that contains DNS entries for the agent-facing load balancer,
and the hostnames it routes to. For example, the load balancer `fleet.example.com`
will route to hostnames `fleet1.example.com` and `fleet2.example.com`.
. Configure the load balancer/reverse proxy.
+
* Ensure the load balancer directs traffic to all {fleet-server} instances.
* Ensure that timeouts for the load balancer have been raised to support the
long-polling connections {agent}s create when checking in to {fleet-server}.
+
By default, the timeout for long-poll in {fleet-server} is 5 minutes, while the
{fleet-server}'s write timeout and the {agent}'s request timeout are set to 10
minutes. In this case, the load balancer timeout should be set to 10 minutes.
+
* (Recommended) Configure the load balancer with TLS pass through.
+
NOTE: Starting with {stack} version 8.19.13, you can use the {fleet-server}
`GET /api/status` API endpoint to determine instance health from the load balancer.
+
. In *{fleet}* > *Settings*, add the load balancer (for example,`https://fleet.example.com:8220`)
Comment thread
vishaangelova marked this conversation as resolved.
as a {fleet-server} host.
. Install {fleet-server} on each backing host using the in-product instructions
which should specify the load balancer as the URL.
. Enroll other {agent} instances using the load balancer URL.

[discrete]
[[add-fleet-server-on-prem-troubleshoot]]
= Troubleshooting
Expand Down