---
name: "Perlbal::Manual::Selector"
section: "3pm"
platform: "linux"
package: "libperlbal-perl"
version: "1.80-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Perlbal::Manual::Selector"
---

# Perlbal::Manual::Selector(3pm)

Configuring Perlbal as a virtual service that maps onto other services

## NAME

Perlbal::Manual::Selector - Configuring Perlbal as a virtual service that maps onto other services

### VERSION

Perlbal 1.78.

### DESCRIPTION

How to configure a Perlbal `"selector"` service.

### READ ME FIRST

Please read Perlbal::Manual::Configuration first for a better explanation on how to configure Perlbal. This document will make much more sense after reading that.

### Configuring Perlbal as a Selector

The `"selector"` role allows you to create a service that selects to which other service a request should be sent to.

Here's an example of how to do that with the help of Perlbal::Plugin::VHosts:

```
    LOAD vhosts
    CREATE SERVICE selector_service
      SET listen         = 0.0.0.0:80
      SET role           = selector
      SET plugins        = vhosts
      VHOST *.site1.com  = service1
      VHOST *.site2.com  = service2
    ENABLE selector_service
```

In this case, requests to both `"site1"` and `"site2"` are received by `"selector_service"`, which then sends requests for `"site1"` to `"service1"` and requests for `"site2"` to `"service2"`.

Depending on your needs, you may want to use an existing plugin (e.g., Perlbal::Plugin::Vhosts, Perlbal::Plugin::VPaths) or create your own (see `"selector"` under Perlbal::Manual::Plugins).

### SEE ALSO

Perlbal::Manual::Configuration, Perlbal::Manual::Management, Perlbal::Manual::Plugins, Perlbal::Plugin::Vhosts, Perlbal::Plugin::VPaths.