Link Search Menu Expand Document

Load Balancing and DNS

This page covers how to point your Load Balancer to lakeFS, and how to set the DNS records. If you already have those, move on to the Setup page.

Load balancing

Depending on how you chose to install lakeFS, you should have a load balancer direct requests to the lakeFS server.
By default, lakeFS operates on port 8000, and exposes a /_health endpoint which you can use for health checks.

Notes for using an AWS Application Load Balancer

  1. Your security groups should allow the load balancer to access the lakeFS server.
  2. Create a target group with a listener for port 8000.
  3. Setup TLS termination using the domain names you wish to use for both endpoints (e.g., *,
  4. Configure the health-check to use the exposed /_health URL


As mentioned in a previous step, you should create 3 DNS records for lakeFS:

  1. One record for the lakeFS API:
  2. Two records for the S3-compatible API: and *

All records should point to your Load Balancer, preferably with a short TTL value.

In AWS Route53

For an AWS load balancer with Route53 DNS, create a simple record, and choose Alias to Application and Classic Load Balancer with an A record type.

Configuring a simple record in Route53

For other DNS providers, refer to the documentation on how to add CNAME records.

You can now move on to the Setup page. c