---
title: influxd backup
description: >
  The `influxd backup` command restores backup data and metadata from an InfluxDB backup directory.
menu:
  influxdb_v1:
    name: influxd backup
    weight: 10
    parent: influxd
alt_links:
  v2: /influxdb/v2/reference/cli/influx/backup/
---

The `influxd backup` command crates a backup copy of specified InfluxDB OSS database(s) and saves the files in an Enterprise-compatible format to PATH (directory where backups are saved).

## Usage

```
influxd backup [flags] PATH
```

## Flags {.no-shorthand}

| Flag           | Description                                                                                                                                       |
|:-------------- |:------------------------------------------------------------------------------------------------------------------------------------------------  |
| `-portable`    | Generate backup files in a portable format that can be restored to InfluxDB OSS or InfluxDB Enterprise. Use unless the legacy backup is required. |
| `-host`        | InfluxDB OSS host to back up from. Optional. Defaults to 127.0.0.1:8088.                                                                          |
| `-db`          | InfluxDB OSS database name to back up. Optional. If not specified, all databases are backed up when using `-portable`.                            |
| `-rp`          | Retention policy to use for the backup. Optional. If not specified, all retention policies are used by default.                                   |
| `-shard`       | The identifier of the shard to back up. Optional. If specified, `-rp` is required.                                                               |
| `-start`       | Include all points starting with specified timestamp (RFC3339 format). Not compatible with `-since`.                                             |
| `-end`         | Exclude all points after timestamp (RFC3339 format). Not compatible with `-since`.                                                               |
| `-since`       | Create an incremental backup of all points after the timestamp (RFC3339 format). Optional. Recommend using `-start` instead.                     |
| `-skip-errors` | Continue backing up the remaining shards when the current shard fails to backup.                                                                  |