---
title: Update a Telegraf configuration
description: Use Telegraf Controller to update Telegraf TOML configuration files.
url: https://docs.influxdata.com/telegraf/controller/configs/update/
estimated_tokens: 364
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/controller/configs/update/
date: '2025-12-31T14:49:32-07:00'
lastmod: '2025-12-31T14:49:32-07:00'
---

Update a configuration to change plugin settings, parameters, and agent-level
options.

## Update a configuration

1. In the Telegraf Controller web interface, select **Configurations** in the
   navigation bar.
2. Click the name of the configuration you want to edit or click the**More button (⋮)** and select **View/Edit**.
3. Update global settings, labels, parameters, and plugin settings as needed.
4. Review the TOML preview and resolve any validation errors.
5. Click **Save**.

### Update configuration name and description

1. In the Telegraf Controller web interface, select **Configurations** in the
   navigation bar.
2. Click the name of the configuration you want to edit or click the**More button (⋮)** and select **View/Edit**.
3. Under **Configuration Information**, click the text under **Name** or**Description**. The name or description will load into a form field.
4. Provide a new name or description and click .

## Auto-update agents

For agents to automatically recognize and load updates to their
configuration, include the `--config-url-watch-interval` with a duration value
that specifies how often the agent should check for updates—for example:

```bash
telegraf \
  --config https://locahost:8888/api/configs/xxxxxx/toml \
  --config-url-watch-interval 1h
```

In this example, the agent will check for configuration changes every hour and
automatically reload the configuration if the configuration has been updated.