Vultr DocsLatest Content


How to Manage Load Balancing Algorithms on a Vultr Load Balancer

Updated on 10 September, 2025

Learn how to select and configure the traffic distribution methods for your Vultr Load Balancer


A Load Balancing algorithm determines how a Vultr Load Balancer distributes incoming traffic to linked instances. Vultr Load Balancers support the Least Connections and Round Robin algorithms that manage the distribution of traffic to instances depending on your application needs.

Follow this guide to manage load balancing algorithms on a Vultr Load Balancer using the Vultr Customer Portal, API, CLI, or Terraform.

  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI
  • Terraform
  1. Navigate to Products and click Load Balancers.

  2. Click your target Load Balancer to open its management page.

  3. In Details, click the pencil icon to edit and manage the Algorithm.

    • Round Robin: Distributes traffic evenly across all linked instances in a circular order.
    • Least Connections: Forwards traffic to the instance with the lowest number of active connections.
  4. Click Save changes to apply the Load Balancing algorithm.

  1. Send a GET request to the List Load Balancers endpoint and note the target Load Balancer's ID.

    console
    $ curl "https://api.vultr.com/v2/load-balancers" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    
  2. Send a PATCH request to the Update Load Balancer endpoint to update the target Load Balancer's algorithm.

    console
    $ curl "https://api.vultr.com/v2/load-balancers/{load-balancer-id}" \
        -X PATCH \
        -H "Authorization: Bearer ${VULTR_API_KEY}" \
        -H "Content-Type: application/json" \
        --data '{                           
            "balancing_algorithm": "{roundrobin_or_leastconn}"
        }'
    
  3. Send a GET request to the Get Load Balancer endpoint to fetch the details of the target Load Balancer.

    console
    $ curl "https://api.vultr.com/v2/load-balancers/{load-balancer-id}" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    
  1. List all available instances and note the target Load Balancer's ID.

    console
    $ vultr-cli load-balancer list
    
  2. Update the target Load Balancer's algorithm.

    console
    $ vultr-cli load-balancer update <load-balancer-id> --balancing-algorithm "<roundrobin_or_leastconn>"
    
  3. Get the details of the target Load Balancer.

    console
    $ vultr-cli load-balancer get <load-balancer-id>
    
  1. Open your Terraform configuration for the existing Load Balancer.

  2. Update the balancing_algorithm field in the configuration.

    terraform
    resource "vultr_load_balancer" "lb" {
        # ...existing fields (region, label, health_check, etc.)
    
        balancing_algorithm = "leastconn"
    }
    
  3. Apply the configuration and observe the following output:

    Apply complete! Resources: 0 added, 1 changed, 0 destroyed.

Comments

No comments yet.