influxd upgrade

InfluxDB OSS only

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.
  3. Creates a script that creates tokens for 1.x users. This script needs to be revised and run manually after starting 2.x.

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]


FlagDescriptionInput type
-m--bolt-pathPath for boltdb database (default ~/.influxdbv2/influxd.bolt)string
-b--bucketPrimary bucket namestring
--config-file(Optional) Custom InfluxDB 1.x config file path, else the default config filestring
-e--engine-pathPath for persistent engine files (default ~/.influxdbv2/engine)string
-f--forceSkip the confirmation prompt
-h--helpHelp for influxd upgrade
--influx-command-pathPath to influx command (default ~/go/bin/influx)string
--log-path(Optional) Custom log file path (default ~/upgrade.log)string
-o--orgPrimary organization namestring
-p--passwordPassword for usernamestring
-r--retention(Optional) Duration bucket will retain data (default 0; retains data infinitely)string
--security-script(Optional) Generated security upgrade script path (default ~/
-t--token(Optional) Token for username. If not specified, a token is auto-generated.string
-u--usernamePrimary usernamestring
--v1-dirPath to source 1.x db directory containing meta, data, and wal sub-folders (default ~/.influxdb)string
-v--verboseVerbose output (default: true)boolean

New! Cloud or OSS?

InfluxDB OSS 2.0 release candidate

InfluxDB OSS v2.0.rc includes breaking changes that require a manual upgrade from all alpha and beta versions. For information, see:

Upgrade to InfluxDB OSS v2.0.rc