# Configuring a Beacon Server

Prior to configuration, a Beacon Server must be installed in your environment. For more information on installing a Beacon server, see this [page](https://documentation.2pintsoftware.com/stifler/2.10/installation/server/stifler-beacon-installation).&#x20;

Once you have validated that the Beacon server is displayed on the Beacons page you can move forward with configuration.

<figure><img src="https://109907496-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FwwooZtszJRGS7JwB7CAT%2FStifleR-2.10-Beacons-List.jpg?alt=media&#x26;token=65e9df49-998f-435b-b6a3-2a8562982a43" alt=""><figcaption></figcaption></figure>

## Adding a Beacon Server to a Template

For clients to be made aware of a Beacon server, it must be added to a [Template](https://documentation.2pintsoftware.com/stifler/2.10/planning/stifler-generic-concepts/templates) which applies to a [Network Group](https://documentation.2pintsoftware.com/stifler/2.10/operations/dashboard/overview-and-navigation/network-topology/network-groups) that clients are within.&#x20;

To add a Beacon server to a template, in the StifleR Dashboard, under **Devices** - **StifleR server** select **Templates**. In the Network group templates list, find the template you want to modify, and select the edit icon.&#x20;

<figure><img src="https://109907496-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FmoHQHWNDAdaY7t3cr2k1%2FStifleR-2.10-EditNetworkGroup.jpg?alt=media&#x26;token=daea30fa-5388-40ed-af97-9a5dd71c04f3" alt=""><figcaption></figcaption></figure>

In the Network group template editor, locate the "Automatic throttling and LEDBAT++ settings" section. In the Beacon field, select the pencil icon. Select the box which appears and a drop down list should open which lists the Beacon servers that have reported into StifleR. Select the Beacon Server you would like to add, and then click the **green check mark** to save the setting.

<figure><img src="https://109907496-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FlYswU2aPVphvuYitqigc%2FStifleR-2.10-BeaconDropDown.jpg?alt=media&#x26;token=f01b5595-bd3a-40af-9872-2fc032ed1fc1" alt=""><figcaption></figcaption></figure>

Once the template is applied and clients are aware of the Beacon server, they will begin measuring their bandwidth. \
The "Measure vs template values" setting includes two options:

* **Beacon measure wins -** if set, the StifleR Server will adjust the limits based on new measurements. This makes it possible to automatically bandwidth and override the template.&#x20;
* **Template wins -** if set, the StifleR Server will ignore any beacon measurements and always use whatever is set in the template.

**To enable scheduled measurments, change "automatic bandwidth tuning" to value 16**

Click the pencil icon to choose which setting you would like to apply.

## Manually Executing a Measurement

Beacons should receive measurements automatically, but you can also execute a measurement manually.&#x20;

To manually execute a Beacon measurement, open the applicable Network Group the Beacon services by selecting the Network Group in the Network group list.

<figure><img src="https://109907496-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2F16uwzlaLPoWw304h8fZZ%2FStifleR-2.10-SelectNetworkGroup.jpg?alt=media&#x26;token=b41befdf-4555-4ff6-a0bf-c81b679b50e7" alt=""><figcaption></figcaption></figure>

In the Network Group page, in the "Bandwidth and throttling settings" section, click the **Measure Now** link which should force a measurement. After a short time, this measurement should be reflected in the  table on the Beacons page.&#x20;

<figure><img src="https://109907496-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYUaU4nvWOjjzrdVpKtdy%2Fuploads%2FVJYEQnj37ch4iECFWn8a%2FStifleR-2.10-Beacon-MeasureNow.jpg?alt=media&#x26;token=4b92f972-720f-4436-abc6-737035f3d6c9" alt=""><figcaption></figcaption></figure>
