---
title: telegraf config
description: The telegraf config command generates Telegraf configuration files and migrates deprecated plugins in configuration files.
url: https://docs.influxdata.com/telegraf/v1/commands/config/
estimated_tokens: 996
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/commands/config/
date: '2024-04-03T14:36:07-06:00'
lastmod: '2024-04-03T14:36:07-06:00'
---

The `telegraf config` command generates Telegraf configuration files and migrates deprecated plugins in configuration files.

## Usage

```sh
telegraf [global-flags] config [subcommand] [flags]
```

## Subcommands

|                        Subcommand                        |                  Description                  |
|----------------------------------------------------------|-----------------------------------------------|
|[create](/telegraf/v1/commands/config/create/) *(default)*|  Create and output a Telegraf configuration   |
|     [migrate](/telegraf/v1/commands/config/migrate/)     |Migrate deprecated plugins to supported plugins|
|                         help, h                          |               Show command help               |

## Flags

|Flag|                      |                                                              Description                                                               |
|----|----------------------|----------------------------------------------------------------------------------------------------------------------------------------|
|    |  `--section-filter`  |Filter sections to print separated by `:` (Valid values are `agent`, `global_tags`, `outputs`, `processors`, `aggregators` and `inputs`)|
|    |   `--input-filter`   |                                                Filter inputs to enable separated by `:`                                                |
|    |  `--output-filter`   |                                               Filter outputs to enable separated by `:`                                                |
|    |`--aggregator-filter` |                                             Filter aggregators to enable separated by `:`                                              |
|    | `--processor-filter` |                                              Filter processors to enable separated by `:`                                              |
|    |`--secretstore-filter`|                                            Filter secret-stores to enable separated by `:`                                             |
|`-h`|       `--help`       |                                                           Show command help                                                            |

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

## Examples

* [Create a full configuration](#create-a-full-configuration)
* [Create a full configuration as save it to a file](#create-a-full-configuration-as-save-it-to-a-file)
* [Create a configuration with specific sections and plugins](#create-a-configuration-with-specific-sections-and-plugins)

### Create a full configuration

```sh
telegraf config
```

### Create a full configuration as save it to a file

```sh
telegraf config > telegraf.conf
```

### Create a configuration with specific sections and plugins

To print a configuration containing only a Modbus input plugin and an
InfluxDB v2 output plugin, run the following:

```sh
telegraf config \
  --section-filter "inputs:outputs" \
  --input-filter "modbus" \
  --output-filter "influxdb_v2"
```
| Subcommand | Description |
| --- | --- |
| Subcommand | Description |
| create   (default) | Create and output a Telegraf configuration |
| migrate | Migrate deprecated plugins to supported plugins |
| help, h | Show command help |

| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
|  | --section-filter | Filter sections to print separated by  :  (Valid values are  agent ,  global_tags ,  outputs ,  processors ,  aggregators  and  inputs ) |
|  | --input-filter | Filter inputs to enable separated by  : |
|  | --output-filter | Filter outputs to enable separated by  : |
|  | --aggregator-filter | Filter aggregators to enable separated by  : |
|  | --processor-filter | Filter processors to enable separated by  : |
|  | --secretstore-filter | Filter secret-stores to enable separated by  : |
| -h | --help | Show command help |