> For the complete documentation index, see [llms.txt](https://docs.stepsecurity.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stepsecurity.io/developer-machines/installation/settings.md).

# Settings

The **Settings** page manages organization-wide Dev Machine Guard configuration: the telemetry key that agents authenticate with, and the device-activity threshold that controls when a device is marked inactive.

These settings apply to every device in your organization.

<figure><img src="/files/7Bec9NZg0f3S6QEb81Yb" alt=""><figcaption></figcaption></figure>

### Telemetry Key

Dev Machine Guard agents authenticate to the StepSecurity backend using a telemetry key. The key is used by all Dev Machine Guard agents on your tenant.

The backend supports two keys, **Primary** and **Secondary**, and accepts either one. This lets you rotate keys without downtime: agents keep using their baked-in key until they are redeployed.

**Fields**

* **Key selector**: switch between the **Primary** and **Secondary** key.
* **Key value**: masked by default. Use the reveal (eye) icon to view it and the copy icon to copy it.
* **Rotate**: generate a new value for the selected key.
* **Last rotated**: shows when the selected key was last rotated (`Never` if it has not been rotated).

#### Rotating the telemetry key

Because the backend accepts either key, rotate in this order to avoid interrupting agents:

1. Rotate the **Secondary** key.
2. Redeploy your fleet with the new Secondary key so agents pick it up.
3. Rotate the **Primary** key.

Agents continue authenticating with their baked-in key until they are redeployed, so following this order ensures no device loses connectivity mid-rotation.

### Device Activity

Device Activity controls when a device is marked inactive in the device list. This applies to every device in your organization.

**Current setting** shows the active threshold in plain language, for example: *Devices are marked inactive after 3 days without telemetry.*

**Inactive after (days)**: mark a device inactive once it has not reported telemetry for this many days. Enter a value in the **Days** field and select **Save device activity** to apply it.

{% hint style="info" %}
This is the same threshold exposed as **Inactive threshold** in Step 3 of the [Script](/developer-machines/installation/script.md) wizard. Changing it in either place updates the organization-wide setting.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.stepsecurity.io/developer-machines/installation/settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.