influx replication create

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 Maps to ?
-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-id Remote bucket ID to replicate data to 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


Authentication credentials

The examples below assume your InfluxDB host, organization, and token are provided by the active influx CLI configuration. If you do not have a CLI configuration set up, use the appropriate flags to provide these required credentials.

Create a replication stream

  1. Create a remote connection, if you haven’t already.
  2. Use 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    [...]
  3. Create the replication:
    influx replication create \
      --name myreplication
      --local-bucket example-local-bucket
      --remote-bucket example-remote-bucket
      --remote-id 0ooxX0xxXo0x

Was this page helpful?

Thank you for your feedback!

Set your InfluxDB URL

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.