<!-- review: finished -->

<a id="external-combined-upstreams"></a>

# Combined Upstreams

The module allows combining multiple server groups into one.

It introduces the `add_upstream`, `combine_server_singlets`, and
`extend_single_peers` directives available within `upstream`
configuration blocks, as well as a new `upstrand` configuration block for
creating higher-level `upstream` blocks. In addition, it introduces the
`dynamic_upstrand` directive for selecting `upstream` blocks at runtime.

<a id="installation-107"></a>

## Installation

To [install](https://en.angie.software//angie/docs/installation/index.md#install-packages) the module, use one of the following packages:

- Angie: `angie-module-combined-upstreams`
- Angie PRO: `angie-pro-module-combined-upstreams`

<a id="loading-the-module-107"></a>

## Loading the module

To use the module, load it in the `main{}` context:

```nginx
load_module modules/ngx_http_combined_upstreams_module.so;
```

<a id="additional-information-107"></a>

## Additional information

Detailed documentation and source code are available at:
[https://github.com/lyokha/nginx-combined-upstreams-module](https://github.com/lyokha/nginx-combined-upstreams-module)

Configuration examples and a detailed breakdown of the module directives:

- [http://lin-techdet.blogspot.com/2011/10/nginx.html](http://lin-techdet.blogspot.com/2011/10/nginx.html)
- [http://lin-techdet.blogspot.com/2015/12/nginx.html](http://lin-techdet.blogspot.com/2015/12/nginx.html)
