Install and use the influx CLI

Do one of the following:

• Use Homebrew
• Manually download and install

Use Homebrew

brew install influxdb-cli

Manually download and install

1. Download the influx CLI package from your browser or from the command line.

   Download from your browser

   influx CLI v2.7.5 (macOS)

   Download from the command line

   curl -LO https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-darwin-amd64.tar.gz \
       --output-dir ~/Downloads
   

   • Copy
   • Fill window

2. Unpackage the downloaded binary.

   Do one of the following:

   • In Finder, double-click the downloaded package file.

   • In your terminal (for example, Terminal or iTerm2) use tar to extract the package–for example, enter the following command to extract it into ~/Downloads:

     tar zxvf ~/Downloads/influxdb2-client-2.7.5-darwin-amd64.tar.gz \
       --directory ~/Downloads
     

     • Copy
     • Fill window

3. Optional: Place the influx binary in your $PATH–for example, copy the binary to /usr/local/bin:

   sudo cp ~/Downloads/influx /usr/local/bin/
   

   • Copy
   • Fill window

   With the influx binary in your $PATH (/usr/local/bin), you can enter influx in your terminal to run the CLI.

   If you do not move the influx binary into your $PATH, enter the path to the binary to run the CLI–for example:

   ~/Downloads/influx
   

   • Copy
   • Fill window

4. (macOS Catalina and newer) Authorize the influx binary.

   macOS requires downloaded binaries to be signed by registered Apple developers. When you first attempt to run influx, macOS prevents it from running. To authorize the influx binary:

   Allow the binary on macOS Ventura

   1. Follow the preceding instructions to attempt to start influx.
   2. Open System Settings and click Privacy & Security.
   3. Under the Security heading, there is a message about “influxd” being blocked, click Allow Anyway.
   4. When prompted, enter your password to allow the setting.
   5. Close System Settings.
   6. Attempt to start influx.
   7. A prompt appears with the message “macOS cannot verify the developer of “influx”…”". Click Open.

   Allow the binary on macOS Catalina

   1. Attempt to run an influx command.
   2. Open System Preferences and click Security & Privacy.
   3. Under the General tab, there is a message about influx being blocked. Click Open Anyway.

1. Download the influx CLI package from your browser or from the command line.

   Download from your browser

   influx CLI v2.7.5 (amd64) influx CLI v2.7.5 (arm)

   Download from the command line

   # amd64
   wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-amd64.tar.gz
   

   • Copy
   • Fill window

   # arm
   wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-linux-arm64.tar.gz
   

   • Copy
   • Fill window

2. Unpackage the downloaded binary.

   Note: The following commands are examples. Adjust the filenames, paths, and utilities if necessary.

   # amd64
   tar xvzf ./influxdb2-client-2.7.5-linux-amd64.tar.gz
   

   • Copy
   • Fill window

   # arm
   tar xvzf ./influxdb2-client-2.7.5-linux-arm64.tar.gz
   

   • Copy
   • Fill window

3. Optional: Place the unpackaged influx executable in your system $PATH.

   # amd64
   sudo cp ./influx /usr/local/bin/
   

   • Copy
   • Fill window

   # arm
   sudo cp ./influx /usr/local/bin/
   

   • Copy
   • Fill window

   If you do not move the influxd binary into your $PATH, enter the path to the binary to start the server–for example:

   ./influx
   

   • Copy
   • Fill window

1. Download the influx CLI package.

   influx CLI v2.7.5 (Windows)

2. Expand the downloaded archive.

   Expand the downloaded archive into C:\Program Files\InfluxData\ and rename it if desired.

   > Expand-Archive .\influxdb2-client-2.7.5-windows-amd64.zip -DestinationPath 'C:\Program Files\InfluxData\'
   > mv 'C:\Program Files\InfluxData\influxdb2-client-2.7.5-windows-amd64' 'C:\Program Files\InfluxData\influx'
   

   • Copy
   • Fill window

3. Grant network access to the influx CLI.

   When using the influx CLI for the first time, Windows Defender displays the following message:

   Windows Defender Firewall has blocked some features of this app.

   To grant the influx CLI the required access, do the following:

   1. Select Private networks, such as my home or work network.
   2. Click Allow access.