# Install influxdb-cli with Homebrew, winget CLI for managing resources in InfluxDB v2. Version 2.8.0 via Homebrew; verified 2026-06-22. ## Install ```sh sudo av install brew:influxdb-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install influxdb-cli ``` Evidence: local Homebrew formula metadata ### Windows - winget (92%): ```sh winget install --id InfluxData.InfluxDB.CLI -e ``` Evidence: Windows Package Manager source index: InfluxData.InfluxDB.CLI from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:influxdb-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.8.0 - **Source summary:** CLI for managing resources in InfluxDB v2 - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-22T14:03:47-07:00 - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - influx (cli) - influx (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.8.0 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/influxdata/influx-cli - info: No cached GitHub release or tag data was available. ## Project history and usage InfluxDB CLI is the separately packaged influx command for managing InfluxDB v2 resources. It handles setup, config profiles, organizations, buckets, authorizations, tasks, templates, backups, restores, writes, queries, and related administrative workflows. ### Project history InfluxDB v2 originally shipped the influx CLI alongside the server. InfluxData release notes announced that beginning with InfluxDB 2.1 the CLI would no longer be packaged with the server release, and future CLI versions would come from the influxdata/influx-cli repository. The influx-cli README explains the split plainly: decoupling made it easier to track InfluxDB Cloud API changes, ship CLI-only fixes faster, and build releases for more platforms than the server could support. That turned influx from a server-adjacent binary into a separately versioned package. ### Adoption history The CLI remained central to InfluxDB v2 operations after the split because the docs use it for setup, writing data, querying data, profile management, and automation. The input metadata shows a dedicated Homebrew formula and winget package, separate from the InfluxDB server package. ### How it is used Users run influx setup to initialize a v2 instance, manage config profiles stored under ~/.influxdbv2/configs, create buckets and organizations, manage auth tokens, write line protocol, run Flux queries, and automate backup or restore operations. The separate package is especially useful on admin workstations that need to control remote InfluxDB servers without installing the server. ### Why package nerds care influxdb-cli is a neat packaging case study: a CLI split out of a database server because cloud APIs, platform support, and release cadence needed a smaller artifact. Package managers expose that boundary directly by shipping influxdb-cli apart from influxdb. ### Timeline - 2020: InfluxDB 2.0 GA shipped with v2 API, Flux, setup, backup, and restore CLI workflows. - 2021: InfluxDB 2.1 packaging notes announced the CLI/server split. - 2021: influx CLI v2.1.0 documented as the first release from influxdata/influx-cli. - 2026: influx CLI v2.8.0 release notes documented continued standalone maintenance. ### Related projects - InfluxDB v2 is the server line this CLI manages. InfluxDB Cloud drove part of the decoupling rationale. Flux, InfluxQL compatibility, OpenAPI-generated clients, and the InfluxData downloads portal are closely related to the CLI's workflows and distribution. ### Sources - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.influxdbv2/configs ## Credential files - Unix: ~/.influxdbv2/configs ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** influxdb-cli - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - winget - InfluxData.InfluxDB.CLI: normalized package name match | Windows Package Manager source index: InfluxData.InfluxDB.CLI from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [influxdb](https://www.automicvault.com/pkg/brew/influxdb/) - Package name indicates the same formula family. - [influxdb@1](https://www.automicvault.com/pkg/brew/influxdb-1/) - Package name indicates the same formula family. - [influxdb@2](https://www.automicvault.com/pkg/brew/influxdb-2/) - Package name indicates the same formula family. - [questdb](https://www.automicvault.com/pkg/brew/questdb/) - Shares av.db curated category or tags: cli, data, database, time-series. - [kapacitor](https://www.automicvault.com/pkg/brew/kapacitor/) - Shares av.db curated category or tags: cli, data, influxdb, time-series. - [traildb](https://www.automicvault.com/pkg/brew/traildb/) - Shares av.db curated category or tags: cli, data, database, time-series. - [automysqlbackup](https://www.automicvault.com/pkg/brew/automysqlbackup/) - Shares av.db curated category or tags: cli, data, database. - [basex](https://www.automicvault.com/pkg/brew/basex/) - Shares av.db curated category or tags: cli, data, database. - [berkeley-db](https://www.automicvault.com/pkg/brew/berkeley-db/) - Shares av.db curated category or tags: cli, data, database. - [couchdb](https://www.automicvault.com/pkg/brew/couchdb/) - Shares av.db curated category or tags: cli, data, database. - [dbxml](https://www.automicvault.com/pkg/brew/dbxml/) - Shares av.db curated category or tags: cli, data, database. - [flux](https://www.automicvault.com/pkg/brew/flux/) - Local package facts share a topical domain. Shared terms: cli, data, influxdb, series, time. - [influxdb-lite](https://www.automicvault.com/pkg/npm/influxdb-lite/) - Local package facts share a topical domain. Shared terms: cli, data, influx, influxdb, series. ## Combined YAML source View the package source record on GitHub. [combined/influxdb-cli.yml](https://github.com/automic-vault/db/blob/main/combined/influxdb-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph