influxctl release notes


Bug fixes

  • Introduced trace HTTP debug CLI option.
  • Added custom gRPC error message handling to gRPC experience.

Dependency updates

  • Update to go1.22.0.
  • Update v14.0.2 to v15.0.0.
  • Update from 1.5.0 to 1.6.0.
  • Update from 6.5.3 to 6.5.4.
  • Update from 0.14.0 to 0.15.0.
  • Update from 0.16.0 to 0.17.0.
  • Update from 1.60.1 to 1.61.0.


Bug fixes

  • Show empty value for database limits when not set, rather than zero.
  • Use user configured port for write.
  • Correct typos in query and write error messages.

Dependency updates

  • Update to go1.21.6.
  • Update from 14.0.1 to 14.0.2.
  • Update from 1.3.6 to 1.3.7.
  • Update from 6.4.9 to 6.5.3.
  • Update from 2.26.0 to 2.27.1.
  • Update from 0.16.0 to 0.17.0.
  • Update from 0.15.0 to 0.16.0.
  • Update from 1.60.0 to 1.60.1.
  • Update from 1.31.0 to 1.32.0.


Bug fixes

  • Correctly set the version and build info for the version command.


Bug fixes

  • Update influxctl query examples with SQL instead of InfluxQL.
  • Update example connection profile configuration with query and write options.
  • Use database and token CLI options if set.


This release includes the following notable changes:

  • InfluxDB Cloud Dedicated users now have the same influxctl login experience as InfluxDB Clustered users. The Auth0 server uses device authorization by displaying a code to validate when logging in. The browser still opens, if possible, and pre-populates the code. The only difference is the need to verify the code on one additional page. This was done to align the user experience between both InfluxDB Cloud Dedicated and InfluxDB Clustered and to allow Cloud Dedicated users without a local UI or browser to continue to use influxctl.
  • Introduce the influxctl write and influxctl query commands. influxctl query queries an InfluxDB v3 instance using SQL. influxctl write writes line protocol to a InfluxDB v3 instance.


  • Introduce influxctl query command.
  • Introduce influxctl write command.
  • Use device auth for InfluxDB Cloud Dedicated.

Bug fixes

  • Avoid nil pointer for database information.
  • Login and early return for TokenFile in InfluxDB Clustered.

Dependency updates

  • Update from 5.10.0 to 5.10.1.
  • Update from 5.10.1 to 5.11.0.
  • Update from 5.1.0 to 5.2.0.
  • Update from 2.25.7 to 2.26.0.
  • Update from 0.14.0 to 0.15.0.


Bug fixes

  • Include error message description in device authorization polling errors.
  • Do not save tokens when loading from file.
  • Update header comments in the example config.toml.

Dependency updates

  • Update from 5.0.0 to 5.1.0.
  • Update from 0.13.0 to 0.14.0.


Features updated in this release are meant for internal InfluxData use and do not affect any public APIs.

Dependency updates

  • Update from 5.9.0 to 5.10.0.
  • Update from 1.3.1 to 1.4.0.
  • Update from 6.4.8 to 6.4.9.
  • Update from 0.13.0 to 0.14.0.



  • Allow token authentication for InfluxDB Clustered.



Bug fixes

  • Use correct account and cluster names when specified in command flags.
  • Make influxctl database list return an empty array instead of null when there are no databases to list.

Dependency updates

  • Update to Go 1.21.3.
  • Update from 6.4.7 to 6.4.8.
  • Update from 1.25.0 to 1.26.0.
  • Update from 0.12.0 to 0.13.0.
  • Update from 0.15.0 to 0.17.0.
  • Update from 0.12.0 to 0.13.0.
  • Update from 1.58.0 to 1.59.0.


  • Automate Homebrew tap releases for influxctl.


Bug fixes

  • Validate Microsoft Entra ID (formerly Azure Active Directory) token and device URLs.
  • Only validate Microsoft Entra ID configuration when getting a token.

Dependency updates

  • Update to Go 1.21.


Bug fixes

Dependency updates

  • Update from 1.3.0 to 1.3.1.
  • Update from 6.4.6 to 6.4.7.
  • Update from 2.0.9 to 2.1.0.
  • Update from 0.11.0 to 0.12.0.
  • Update from 1.57.0 to 1.58.0.


Bug fixes

Dependency updates

  • Update from 0.8.0 to 0.12.0.


  • Clean up log formatting.
  • Remove extra debug output of account ID.


Bug fixes

  • Return an error when using unrecognized TOML configuration options.


influxctl 2.0.0 introduces support for both InfluxDB Cloud Dedicated and InfluxDB Clustered. To simplify configuration profile management, all connection configurations now managed in a single configuration file. If using influxctl 1.x, migrate your 1.x configuration profiles to the 2.0 format:

Migrate from influxctl 1.x to 2.0

influxctl 2.0+ supports multiple InfluxDB v3 products. To simplify connection configuration management, all configurations are now managed in a single file rather than separate files for each connection configuration.

To migrate influxctl 1.x configuration files to the 2.x format, use the following guidelines:

  1. Create a 2.0+ configuration file (config.toml) at the default location for your operating system. See Create a configuration file.

  2. Copy the account_id and cluster_id credentials from your influxctl 1.x configuration file and add them to a [[profile]] TOML table along with the following fields:

    • name: Profile name
    • product: InfluxDB product (dedicated)

    For example, the following 1.x configuration file:

    account_id = "dff3ee52-b494-47c1-9e2c-ab59d90d94eb"
    cluster_id = "5827cdeb-b868-4446-b40e-e08de116fddf"

    would become:

        name = "default"
        product = "dedicated"
        account_id = "dff3ee52-b494-47c1-9e2c-ab59d90d94eb"
        cluster_id = "5827cdeb-b868-4446-b40e-e08de116fddf"


  • Add support for both InfluxDB Cloud Dedicated and InfluxDB Clustered.
  • Provide public distributions through and the repository.
  • The influxctl configuration file is now a single file that you can optionally pass in via the CLI.
  • Add additional options to influxctl database and influxctl token subcommands.
  • Introduce influxctl cluster subcommands.
  • Remove the influxctl init subcommand to avoid additional complexity of an InfluxDB Cloud Dedicated configuration.
  • Set maximum tables and columns when creating a database.
  • Support passing a connection configuration file path as a CLI option.
  • Delete multiple tokens or database in one command.
  • Disable of TLS verification for self-signed certificates.
  • Update a database and token values.
  • Update account & cluster ID for configurations for InfluxDB Clustered.
  • Add account and authz gRPC method support.
  • Add account and authz protofiles.
  • Add oauth2 authentication.
  • Specify custom TLS certificates.
  • Store configuration settings for multiple InfluxDB products in a single configuration file.

Bug Fixes

  • Return error when too many arguments are provided to a command.
  • Set token directory permissions to only the current user.
  • Unmarshal expires_in for device OAuth2 token.
  • Update authentication host for InfluxDB Cloud Dedicated.
  • Verify account and cluster IDs.


  • Update configuration examples with InfluxDB Clustered configurations.
  • Properly close gRPC connections.
  • Update error message for missing connection profiles.

Dependency Updates

  • Update from 2.0.7 to 2.0.9.
  • Update from 1.8.2 to 1.8.4.
  • Update from 2.25.3 to 2.25.7.
  • Update from 1.24.0 to 1.25.0.
  • Update from 0.9.0 to 0.11.0.
  • Update from 1.55.0 to 1.57.0.
  • Update from 1.30.0 to 1.31.0.



  • Add the influxctl database update subcommand to update retention periods.
  • Add the influxctl token update subcommand to update token descriptions.
  • Using the influxctl init command:
    • Confirm before overwriting an existing profile.
    • Remove the existing token if overwriting a profile.
  • On error, use stderr and return non-zero return code.
  • Increase command timeouts to 60 seconds.
  • Support setting the Auth0 and gRPC destinations using environment variables for staging and development environment use.

Bug fixes

  • Call Makefile instead of goreleaser.
  • Remove token on init.

Dependency updates

  • Update from 2.25.1 to 2.25.3.
  • Update from 0.7.0 to 0.8.0.
  • Update from 1.54.0 to 1.55.0.



  • Output confirmation messages on delete.
  • Use production Authentication service URLs.


  • Display 0s retention policies as infinite.

Was this page helpful?

Thank you for your feedback!

Introducing InfluxDB Clustered

A highly available InfluxDB 3.0 cluster on your own infrastructure.

InfluxDB Clustered is a highly available InfluxDB 3.0 cluster built for high write and query workloads on your own infrastructure.

InfluxDB Clustered is currently in limited availability and is only available to a limited group of InfluxData customers. If interested in being part of the limited access group, please contact the InfluxData Sales team.

Learn more
Contact InfluxData Sales

The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: