docs-v2/content/v2.0/backup-restore/backup.md

1.4 KiB

title seotitle description menu weight related products
Back up data Back up data in InfluxDB Use the `influx backup` command to back up data and metadata stored in InfluxDB.
v2_0
parent
Back up & restore data
101
/v2.0/backup-restore/restore/
/v2.0/reference/cli/influx/backup/
oss

Use the influx backup command to back up data and metadata stored in InfluxDB. InfluxDB copies all data and metadata to a set of files stored in a specified directory on your local filesystem.

{{% warn %}} If you set up InfluxDB using v2.0.0-beta.1 or earlier, you cannot back up data. Root tokens created prior to v2.0.0-beta.2 do not have the necessary permissions. To succesfully use the backup tool, set up a new InfluxDB instance using v2.0.0-beta.2+. {{% /warn %}}

{{% cloud %}} The influx backup command cannot back up data stored in {{< cloud-name "short" >}}. {{% /cloud %}}

The influx backup command requires:

  • The directory path for where to store the backup file set
  • The root authorization token (the token created for the first user in the InfluxDB setup process).
Back up data with the influx CLI
# Syntax
influx backup -p <backup-path> -t <root-token>

# Example
influx backup \
  -p path/to/backup_$(date '+%Y-%m-%d_%H-%M') \
  -t xXXXX0xXX0xxX0xx_x0XxXxXXXxxXX0XXX0XXxXxX0XxxxXX0Xx0xx==