---
title: Create a Telegraf configuration
description: Use the InfluxDB UI or the influx CLI to create an Telegraf configuration.
url: https://docs.influxdata.com/influxdb/v2/tools/telegraf-configs/create/
estimated_tokens: 804
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/tools/telegraf-configs/create/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

Telegraf has an extensive list of plugins for many different technologies and use cases.
Not all plugins are available through the InfluxDB UI, but you can[create and upload custom Telegraf configurations](#create-a-custom-telegraf-configuration)to include any of the available [Telegraf plugins](/telegraf/v1/plugins/).

Use the InfluxDB user interface (UI) or the [`influx` CLI](/influxdb/v2/reference/cli/influx/)to create a Telegraf configuration.

To create a Telegraf configuration, do one of the following:

* [Use the InfluxDB UI](#use-the-influxdb-ui)
* [Use the `influx` CLI](#use-the-influx-cli)
* [Create a custom Telegraf configuration](#create-a-custom-telegraf-configuration)

## Use the InfluxDB UI

Use the InfluxDB UI to automatically generate and store new Telegraf configurations in InfluxDB.
Creating the configuration in the UI lets you select from a list of available technologies and generates a Telegraf configuration to collect metrics from those technologies.
For more information, see [Automatically configure Telegraf](/influxdb/v2/write-data/no-code/use-telegraf/auto-config/).

## Use the influx CLI

Use the [`influx telegrafs create` command](/influxdb/v2/reference/cli/influx/telegrafs/create/)to upload a Telegraf configuration file from your local machine and create a new Telegraf
configuration in InfluxDB.

Provide the following:

* **Telegraf configuration name**
* **Telegraf configuration description**
* **Telegraf configuration file**

> [!Note]
> If a **name** and **description** are not provided, they are set to empty strings.

```sh
# Syntax
influx telegrafs create \
  -n <telegraf-config-name> \
  -d <telegraf-config-description> \
  -f /path/to/telegraf.conf

# Example
influx telegrafs create \
  -n "Example Telegraf config"
  -d "This is a description for an example Telegraf configuration."
  -f /path/to/telegraf.conf
```

## Create a custom Telegraf configuration

1. Create a custom Telegraf configuration file that includes the `outputs.influxdb_v2`output plugin. *See [Manually configure Telegraf](/influxdb/v2/write-data/no-code/use-telegraf/manual-config/)*for more information.
2. Add and customize [Telegraf plugins](/telegraf/v1/plugins/) and save your changes.
3. [Use the `influx telegrafs create` command](#use-the-influx-cli) to upload your
   custom Telegraf configuration to InfluxDB.

#### Related

* [Manually configure Telegraf](/influxdb/v2/write-data/no-code/use-telegraf/manual-config/)
* [Automatically configure Telegraf](/influxdb/v2/write-data/no-code/use-telegraf/auto-config/)
* [Update a Telegraf configuration](/influxdb/v2/tools/telegraf-configs/update/)