content/shared/influxdb-v2/reference/cli/influx/replication/create.md
[!Important] Replication remotes and replication streams can only be configured for InfluxDB OSS.
The influx replication create command creates a new InfluxDB replication stream.
influx replication create [command options] [arguments...]
| Flag | Description | Input type | {{< cli/mapped >}} | |
|---|---|---|---|---|
-n | --name | Replication stream name | string | |
-d | --description | Replication stream description | string | |
--org-id | Local organization ID | string | INFLUX_ORG_ID | |
-o | --org | Local organization name | string | INFLUX_ORG |
--remote-id | Remote connection ID to replicate data to | string | ||
--local-bucket-id | Local bucket ID to replicate data from | string | ||
--remote-bucket | Remote bucket name to replicate data to (mutually exclusive with --remote-bucket-id) | string | ||
--remote-bucket-id | Remote bucket ID to replicate data to (mutually exclusive with --remote-bucket-name) | string | ||
--max-queue-bytes | Max queue size in bytes (default: 67108860) | integer | ||
--drop-non-retryable-data | Drop data when a non-retryable error is encountered | |||
--no-drop-non-retryable-data | Do not drop data when a non-retryable error is encountered | |||
--max-age | Specify a maximum age (in seconds) for data before it is dropped | integer | ||
--host | InfluxDB HTTP address (default http://localhost:8086) | string | INFLUX_HOST | |
--skip-verify | Skip TLS certificate verification | INFLUX_SKIP_VERIFY | ||
--configs-path | Path to influx CLI configurations (default ~/.influxdbv2/configs) | string | INFLUX_CONFIGS_PATH | |
-c | --active-config | CLI configuration to use for command | string | |
--http-debug | Inspect communication with InfluxDB servers | string | ||
--json | Output data as JSON (default false) | INFLUX_OUTPUT_JSON | ||
--hide-headers | Hide table headers (default false) | INFLUX_HIDE_HEADERS | ||
-t | --token | InfluxDB API token | string | INFLUX_TOKEN |
{{< cli/influx-creds-note >}}
influx remote list to get the ID for the remote you want to replicate data to.
$ influx remote list
ID Name Org ID
0ooxX0xxXo0x myremote [...]
influx replication create \
--name myreplication
--local-bucket example-local-bucket
--remote-bucket example-remote-bucket
--remote-id 0ooxX0xxXo0x