---
title: telegraf secrets set
description: The telegraf secrets set command creates or modify a secret in a specified secret store.
url: https://docs.influxdata.com/telegraf/v1/commands/secrets/set/
estimated_tokens: 745
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/commands/secrets/set/
date: '2026-05-15T15:46:14-06:00'
lastmod: '2026-05-15T15:46:14-06:00'
---

The `telegraf secrets set` command creates or modify a secret in a specified secret store.

> [!Note]
> This command requires your configuration file that contains the secret store
> definitions you want to access. If the `--config` or `--config-directory` flags
> are not included in the command, Telegraf checks the[default configuration file location](/telegraf/v1/configuration/#configuration-file-locations).

Use [`telegraf secrets list`](/telegraf/v1/commands/secrets/list/) to get the
IDs of available secret stores and the available secret keys.

If you haven’t configured a secret store, use[`telegraf plugins secretstores`](/telegraf/v1/commands/plugins/secretstores/)to list available secret store plugins.
View secret store plugin configuration documentation in the[Telegraf GitHub repository](https://github.com/influxdata/telegraf/tree/master/plugins/secretstores).

## Usage

```sh
telegraf [global-flags] secrets set [flags] <SECRET_STORE_ID> <SECRET_KEY> <SECRET_VALUE>
```

## Arguments

|      Argument       |                Description                |
|---------------------|-------------------------------------------|
|**SECRET\_STORE\_ID**|ID of the secret store to set the secret in|
|   **SECRET\_KEY**   |         Key of the secret to set          |
|  **SECRET\_VALUE**  |        Value of the secret to set         |

## Flags

|Flag|        |   Description   |
|----|--------|-----------------|
|`-h`|`--help`|Show command help|

*Also see [Telegraf global flags](/telegraf/v1/commands/#telegraf-global-flags).*

## Examples

* [Set a secret using the default configuration location](#set-a-secret-using-the-default-configuration-location)
* [Set a secret using a non-default configuration location](#set-a-secret-using-a-non-default-configuration-location)

In the examples below, replace the following:

* `SECRET_STORE_ID`:
  The ID of the secret store to store the secret in.
* `SECRET_KEY`:
  The key of the secret to set.
* `SECRET_VALUE`:
  The value of the secret to set.
* `CUSTOM_CONFIG_PATH`:
  The non-default filepath to your Telegraf configuration file containing your
  secret store definitions.

### Set a secret using the default configuration location

The following example assumes the Telegraf configuration file that contains the
secret store definition is at the [default location](/telegraf/v1/configuration/#configuration-file-locations).

```sh
telegraf secrets set SECRET_STORE_ID SECRET_KEY SECRET_VALUE
```

### Set a secret using a non-default configuration location

```sh
telegraf \
  --config CUSTOM_CONFIG_PATH \
  secrets set \
  SECRET_STORE_ID \
  SECRET_KEY \
  SECRET_VALUE
```
| Argument | Description |
| --- | --- |
| Argument | Description |
| SECRET_STORE_ID | ID of the secret store to set the secret in |
| SECRET_KEY | Key of the secret to set |
| SECRET_VALUE | Value of the secret to set |

| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
| -h | --help | Show command help |