influxd upgrade

This page documents an earlier version of InfluxDB. InfluxDB v2.3 is the latest stable version. View this page in the v2.3 documentation.

Use the influxd upgrade command to upgrade an instance of InfluxDB 1.x to InfluxDB 2.0. This command copies all data in databases and retention policies (used in 1.x) over to buckets (used in 2.0).

Be sure to back up all data before upgrading with influx upgrade.

This command performs the following actions:

  1. Creates the InfluxDB 2.x configuration file using 1.x configuration file options. Unsupported 1.x options are reported to standard output. If the configuration file is not available, the 1.x database folder can be passed via th --v1-dir flag.
  2. Copies and upgrades 1.x database files.

The target 2.x database directory is specified by the --engine-path option. If changed, the bolt path can be specified by the --bolt-path option.


influxd upgrade [flags]
influxd upgrade [command]


Flag Description Input type
-m --bolt-path Path for boltdb database (default ~/.influxdbv2/influxd.bolt) string
-b --bucket Primary bucket name string
--config-file Custom InfluxDB 1.x config file path (default ~/.influxdb/influxdb.conf) string
--continuous-query-export-path Path for exported 1.x continuous queries (default ~/continuous_queries.txt) string
-e --engine-path Path for persistent engine files (default ~/.influxdbv2/engine) string
-f --force Skip the confirmation prompt
-h --help Help for influxd upgrade
-c --influx-configs-path Path for 2.x influx CLI configurations file (default ~/.influxdbv2/configs)
--log-level Supported log levels are debug, info, warn, and error (default info) string
--log-path Custom log file path (default ~/upgrade.log) string
-o --org Primary organization name string
--overwrite-existing-v2 Overwrite existing files at the output paths instead of aborting the upgrade process
-p --password Password for username string
-r --retention Duration bucket will retain data (default 0; retains data infinitely) string
-t --token Token for username. If not specified, a token is auto-generated. string
-u --username Primary username string
--v1-dir Path to source 1.x db directory containing meta, data, and wal sub-folders (default ~/.influxdb) string
--v2-config-path Destination path for upgraded 2.x configuration file (default ~/.influxdbv2/config.toml) string
-v --verbose Verbose output

Was this page helpful?

Thank you for your feedback!

Set your InfluxDB URL

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.