---
title: influxd backup
description: The influxd backup command restores backup data and metadata from an InfluxDB backup directory.
url: https://docs.influxdata.com/influxdb/v1/tools/influxd/backup/
estimated_tokens: 815
product: InfluxDB OSS v1
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v1/tools/influxd/backup/
date: '2025-01-13T07:21:11-07:00'
lastmod: '2025-01-13T07:21:11-07:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

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

|     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.                                 |
| Flag | Description |
| --- | --- |
| 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. |