docs-v2/content/influxdb/v2.1/reference/cli/influx/backup/_index.md

title	description	menu	weight	influxdb/v2.1/tags	related	metadata	updated_in
influx backup	The `influx backup` command backs up data stored in InfluxDB to a specified directory.	influxdb_2_1_ref name parent influx backup influx	101	backup	/influxdb/v2.1/backup-restore/backup/ /influxdb/v2.1/reference/cli/influx/restore/ /influxdb/v2.1/reference/cli/influx/#provide-required-authentication-credentials, influx CLI—Provide required authentication credentials /influxdb/v2.1/reference/cli/influx/#flag-patterns-and-conventions, influx CLI—Flag patterns and conventions	influx CLI 2.0.0+ InfluxDB 2.0.0+	CLI v2.0.2

The influx backup command backs up data stored in InfluxDB to a specified directory.

Usage

influx backup [flags] path

Flags

Flag		Description	Input type	{{< cli/mapped >}}
-c	--active-config	CLI configuration to use for command	string
	--bucket-id	ID of the bucket to back up from (mutually exclusive with --bucket)	string
-b	--bucket	Name of the bucket to back up from (mutually exclusive with --bucket-id)	string
	--compression	By default, gzip argument enables compression on downloaded files. Set to none to disable compression.	string
	--configs-path	Path to influx CLI configurations (default ~/.influxdbv2/configs)	string	INFLUX_CONFIGS_PATH
-h	--help	Help for the backup command
	--hide-headers	Hide table headers (default false)		INFLUX_HIDE_HEADERS
	--host	HTTP address of InfluxDB (default: http://localhost:8086)	string	INFLUX_HOST
	--http-debug	Inspect communication with InfluxDB servers.	string
	--json	Output data as JSON (default false)		INFLUX_OUTPUT_JSON
-o	--org	Organization name (mutually exclusive with --org-id)	string	INFLUX_ORG
	--org-id	Organization ID (mutually exclusive with --org)	string	INFLUX_ORG_ID
	--skip-verify	Skip TLS certificate verification	string	INFLUX_SKIP_VERIFY
-t	--token	API token	string	INFLUX_TOKEN

Examples

{{< cli/influx-creds-note >}}

• Back up all data to a directory
• Back up all data to the current working directory
• Back up a specific bucket to a directory

Back up all data to a directory

influx backup /path/to/backup/dir/

Back up all data to the current working directory

influx backup ./

Back up a specific bucket to a directory

influx backup --bucket example-bucket /path/to/backup/dir/