> For the complete documentation index, see [llms.txt](https://docs.thousandeyes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration.md).

# Configure the Agent

Use this guide to configure `skagent.cfg` and verify the values the agent reads.

Config templates such as RDK-B or OpenSync can supply model, firmware, serial number, and WAN inputs. You must supply the authentication secret. For multi-ISP images, confirm the routing requirements with ThousandEyes.

The table summarizes the key authentication, client identity, device metadata, and WAN fields to update or confirm:

| Field                   | Action                                                         |
| ----------------------- | -------------------------------------------------------------- |
| Authentication secret   | Set a lab secret or inject a production secret securely        |
| Client                  | Set the lab Org Client ID or production routing input          |
| MAC                     | Resolve a stable WAN MAC and check it against the device label |
| Model                   | Confirm the device model or SKU                                |
| Firmware                | Confirm the running version                                    |
| Serial number           | Confirm the device serial number                               |
| Cross-traffic interface | Confirm the active WAN path                                    |

Run this command from the agent installation directory to verify which values the agent reads and whether you need to update the configuration:

```bash
bin/skagent --device-info
```

## Configuration Guides

| Task                                                          | Page                                                                                                                                                                            |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Choosing credentials and production routing                   | [Identity and ISP Routing](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/identity-and-isp-routing.md)                       |
| Applying the OpenSync template                                | [OpenSync](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/opensync.md)                                                       |
| Understanding TCP speed-test capabilities and validation      | [TCP Speed Tests](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/tcp-speed-tests.md)                                         |
| Integrating custom speed-test hooks                           | [Speed-Test Hook Reference](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/speed-test-hook-reference.md)                     |
| Configuring logging levels and sinks                          | [Configuration Reference](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/configuration-reference.md#logging)                 |
| Configuring WAN traffic counters                              | [Configuration Reference](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/configuration-reference.md#cross-traffic-detection) |
| Planning a production deployment and choosing an update model | [Plan, Deploy, and Update the Agent](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/plan-deploy-and-update-the-agent.md)                   |
| Looking up a field or input type                              | [Configuration Reference](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/configuration-reference.md)                         |

Continue to [Validate with Self-Test Mode](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/validation-and-troubleshooting/validate-with-self-test-mode.md).
