Documentation

Migrate to an account in a new region

The following guide provides instructions on migrating data and resources from an existing InfluxDB Cloud account to a new InfluxDB account in another InfluxDB Cloud region.

Create a new account in a new region

InfluxDB organizations are bound to a specific cloud provider and region. Create a new InfluxDB Cloud account in the region you want to migrate to.

Migrate Data

If you want to migrate data from your current InfluxDB Cloud account to your new destination InfluxDB Cloud account, there is documentation available that walks through the migration. The specific process varies depending on whether your destination account is powered by our current database engine, Time-Structured Merge Tree (TSM) or our new database engine, InfluxDB IOx.

To see what which database engine your organization is using, log in to your InfluxDB Cloud account and, on your organization’s homepage, and then look for InfluxDB Cloud powered by TSM or InfluxDB Cloud powered by IOx at the bottom of the far-right column.

Dual write into both organizations

Depending on the duration of your retention policy for storing data it may be easier to temporarily dual write into both the source and destination accounts for an overlapping period until the destination account holds all desired data.

Migrate Resources

Resources include, but are not limited to the following:

  • buckets
  • dashboards
  • notification rules
  • tasks
  • labels
  • variables

If you have resources that you want to migrate to your destination account (rather than recreating these resources in the destination account) you can do the following:

  1. Download and install the 2.x influx CLI.

  2. Set up InfluxDB connection configurations for both your source and destination InfluxDB Cloud accounts. Use the influx config create command and provide the following for each connection:

    # Create your source connection configuration and set it to active
    $ influx config create \
      --config-name source \
      --host-url https://cloud2.influxdata.com \
      --org <your-source-org> \
      --token <your-source-auth-token> \
      --active
    
    # Create your destination connection configuration
    $ influx config create \
      --config-name destination \
      --host-url https://cloud2.influxdata.com \
      --org <your-destination-org> \
      --token <your-destination-auth-token>
    
  3. Use the influx export all command to export all resources from your source account to an InfluxDB template.

    influx export all
    
  4. Use the influx config command to switch to your destination connection configuration. Provide the name of the configuration to switch to:

    influx config destination
    
  5. Use influx template apply command to apply the exported InfluxDB template created in the previous step to your destination account:

    influx apply --file path/to/template.json
    

Was this page helpful?

Thank you for your feedback!


Select your region

Linux Package Signing Key Rotation

All signed InfluxData Linux packages have been resigned with an updated key. If using Linux, you may need to update your package configuration to continue to download and verify InfluxData software packages.

For more information, see the Linux Package Signing Key Rotation blog post.

InfluxDB Cloud backed by InfluxDB IOx

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by IOx, this is the correct documentation.

If powered by TSM, see the TSM-based InfluxDB Cloud documentation.

InfluxDB Cloud backed by InfluxDB TSM

All InfluxDB Cloud organizations created on or after January 31, 2023 are backed by the new InfluxDB IOx storage engine which enables nearly unlimited series cardinality and SQL query support. Check the right column of your InfluxDB Cloud organization homepage to see which InfluxDB storage engine you’re using.

If powered by TSM, this is the correct documentation.

If powered by IOx, see the IOx-based InfluxDB Cloud documentation.

State of the InfluxDB Cloud (IOx) documentation

The new documentation for InfluxDB Cloud backed by InfluxDB IOx is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.