50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
---
|
|
title: Back up data
|
|
seotitle: Back up data in InfluxDB
|
|
description: >
|
|
Use the `influx backup` command to back up data and metadata stored in InfluxDB.
|
|
menu:
|
|
influxdb_v2:
|
|
parent: Back up & restore data
|
|
weight: 101
|
|
related:
|
|
- /influxdb/v2/admin/backup-restore/restore/
|
|
- /influxdb/v2/reference/cli/influx/backup/
|
|
aliases:
|
|
- /influxdb/v2/backup-restore/backup/
|
|
---
|
|
|
|
Use the [`influx backup` command](/influxdb/v2/reference/cli/influx/backup/) 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.
|
|
|
|
{{% note %}}
|
|
#### InfluxDB 1.x/2.x compatibility
|
|
The InfluxDB {{< current-version >}} `influx backup` command is not compatible with versions of InfluxDB prior to 2.0.0.
|
|
**For information about migrating data between InfluxDB 1.x and {{< current-version >}}, see:**
|
|
|
|
- [Automatically upgrade from InfluxDB 1.x to {{< current-version >}}](/influxdb/v2/upgrade/v1-to-v2/automatic-upgrade/)
|
|
- [Manually upgrade from InfluxDB 1.x to {{< current-version >}}](/influxdb/v2/upgrade/v1-to-v2/manual-upgrade/)
|
|
{{% /note %}}
|
|
|
|
> [!Important]
|
|
> The `influx backup` command **cannot** back up data stored in **InfluxDB 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](/influxdb/v2/get-started/)).
|
|
|
|
##### Back up data with the influx CLI
|
|
```sh
|
|
# Syntax
|
|
influx backup <backup-path> -t <root-token>
|
|
|
|
# Example
|
|
influx backup \
|
|
path/to/backup_$(date '+%Y-%m-%d_%H-%M') \
|
|
-t xXXXX0xXX0xxX0xx_x0XxXxXXXxxXX0XXX0XXxXxX0XxxxXX0Xx0xx==
|
|
```
|