0Pricing
API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) · Lesson

Upstream Servers & Load Balancing

Configure Nginx upstream blocks to manage multiple backend servers and distribute incoming requests.

Upstream Servers & Load Balancing is a free API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Scaling Your Applications

As your web application grows, a single server might not be enough to handle all incoming requests. This can lead to slow response times or even crashes.

To prevent this, we use multiple backend servers to share the load. This improves both performance and reliability.

Introducing Upstream Servers

Nginx can act as a reverse proxy, distributing requests to a group of backend servers. These backend servers are often called upstream servers.

  • Scalability: Handle more traffic by adding more servers.
  • High Availability: If one server fails, others can still respond.
  • Load Balancing: Distribute requests efficiently among servers.

The `upstream` Block

In Nginx, you define a group of backend servers using the upstream block. This block gives a name to your group of servers, which you can then reference in your location blocks.

Think of it as a named pool of resources that Nginx can forward requests to.

Basic Upstream Configuration

Here's how to define a simple upstream block named my_backends with two servers. Each server directive specifies the address (IP or hostname) and port of a backend server.

upstream my_backends {
  server 192.168.1.100:8080;
  server 192.168.1.101:8080;
}

Connecting Upstream to `location`

Once an upstream block is defined, you can use it within a location block in your Nginx server configuration. The proxy_pass directive tells Nginx to forward requests to the specified upstream group.

Notice we use http://my_backends to reference our defined group.

http {
  upstream my_backends {
    server 192.168.1.100:8080;
    server 192.168.1.101:8080;
  }

  server {
    listen 80;
    location /app {
      proxy_pass http://my_backends;
    }
  }
}

Default Load Balancing: Round Robin

By default, Nginx uses the Round Robin load balancing method. This means requests are distributed to upstream servers in a rotating, sequential manner.

  • Request 1 goes to Server A.
  • Request 2 goes to Server B.
  • Request 3 goes to Server A.
  • ...and so on.

It's simple and effective for evenly distributed loads.

Customizing Load with `weight`

What if some servers are more powerful or should handle more traffic? You can use the weight parameter in the server directive to assign different priorities.

A server with a higher weight will receive a proportionally larger share of requests.

`weight` Example in Nginx

In this example, server 1 has a weight of 3, and server 2 has a weight of 1. This means server 1 will receive 3 times as many requests as server 2.

Out of every 4 requests, 3 will go to server 1 and 1 to server 2.

upstream my_backends {
  server 192.168.1.100:8080 weight=3;
  server 192.168.1.101:8080 weight=1;
}

Other Server Directives

Beyond weight, other directives can fine-tune server behavior:

  • max_fails=N: Number of failed attempts before Nginx considers the server unavailable.
  • fail_timeout=Xs: Time for which the server is considered unavailable after max_fails attempts.
  • backup: Marks a server as a backup, used only when all primary servers are down.
  • down: Marks a server as permanently unavailable.

These help Nginx manage server health automatically.

Quick Check: Upstream & Load Balancing

Consider the following Nginx configuration snippet:

upstream api_servers {
  server backend1.example.com:8080 weight=2;
  server backend2.example.com:8080;
}

server {
  listen 80;
  location /api {
    proxy_pass http://api_servers;
  }
}

If 9 requests arrive at the /api endpoint, how many requests will be sent to backend1.example.com:8080?

Recap & Next Steps

You've learned how Nginx uses upstream blocks to group multiple backend servers, enabling load balancing and improving application resilience.

  • upstream block: Defines a named group of servers.
  • proxy_pass: Connects a location to an upstream group.
  • Round Robin: Nginx's default load balancing method.
  • weight directive: Customizes request distribution among servers.

Next, we'll explore how Nginx can improve performance with proxy buffering and caching!

Frequently asked questions

Is the “Upstream Servers & Load Balancing” lesson free?

Yes — the full text of “Upstream Servers & Load Balancing” is free to read here on the web, and the API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) course, upgrade to CoddyKit PRO.

What will I learn in “Upstream Servers & Load Balancing”?

Configure Nginx upstream blocks to manage multiple backend servers and distribute incoming requests. You practise API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

No prior experience is required. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Upstream Servers & Load Balancing” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) lesson?

Yes. Every API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. Configuring Simple Reverse Proxy
  2. Upstream Servers & Load Balancing
  3. Proxy Buffering & Caching
  4. Forwarding Headers & Client IP
← Back to API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)