Sign up for InfluxDB Cloud

Step 1: Download influx CLI for macOS

Click the following button to download and install influx CLI for macOS.

influx CLI (macOS)

Step 2: Unpackage the influx binary

Note: The commands below are examples. Adjust the file names, paths, and utilities to your own needs.

To unpackage the downloaded archive, double click the archive file in Finder or run the following command in a macOS command prompt application such Terminal or iTerm2:

# Unpackage contents to the current working directory
tar zxvf ~/Downloads/influxdb2-client-2.7.5-darwin-amd64.tar.gz

Step 3: (Optional) Place the binary in your $PATH

If you choose, you can place influx in your $PATH or you can prefix the executable with ./ to run in place. If the binary is on your $PATH, you can run influx from any directory. Otherwise, you must specify the location of the CLI (for example, ./influxor path/to/influx).

Note: If you have the 1.x binary on your $PATH, moving the 2.0 binary to your $PATH will overwrite the 1.x binary because they have the same name.

# Copy the influx binary to your $PATH
sudo cp influxdb2-client-2.7.5-darwin-amd64/influx /usr/local/bin/

Step 4: (macOS Catalina only) Authorize InfluxDB binaries

If running influx on macOS Catalina, you must manually authorize the influx binary in the Security & Privacy section of System Preferences.

Step 5: Set up a configuration profile

To avoid having to pass your InfluxDB API token with each influx command, set up a configuration profile that stores your credentials.

In a terminal, run the following command:

# Set up a configuration profile
influx config create -n default \
  -u https://cloud2.influxdata.com \
  -o example-org \
  -t mySuP3rS3cr3tT0keN \
  -a

This configures a new profile named default and makes the profile active so your influx CLI commands run against this instance. For more detail, see influx config.

Step 6: Learn influx CLI commands

To see all available influx commands, type influx -h or check out influx - InfluxDB command line interface.

Step 1: Download influx CLI for Linux

Click one of the following buttons to download and install the influx CLI appropriate for your chipset.

influx CLI (amd64) influx CLI (arm)

Step 2: Unpackage the influx binary

Note: The commands below are examples. Adjust the file names, paths, and utilities to your own needs.

# Unpackage contents to the current working directory
tar xvfz influxdb2-client--linux-amd64.tar.gz

Step 3: (Optional) Place the binary in your $PATH

If you choose, you can place influx in your $PATH or you can prefix the executable with ./ to run in place. If the binary is on your $PATH, you can run influx from any directory. Otherwise, you must specify the location of the CLI (for example, ./influxor path/to/influx).

Note: If you have the 1.x binary on your $PATH, moving the 2.0 binary to your $PATH will overwrite the 1.x binary because they have the same name.

# Copy the influx and influxd binary to your $PATH
sudo cp influxdb2-client--linux-amd64/influx /usr/local/bin/

Step 4: Set up a configuration profile

To avoid having to pass your InfluxDB API token with each influx command, set up a configuration profile that stores your credentials.

In a terminal, run the following command:

# Set up a configuration profile
influx config create -n default \
  -u https://cloud2.influxdata.com \
  -o example-org \
  -t mySuP3rS3cr3tT0keN \
  -a

This configures a new profile named default and makes the profile active so your influx CLI commands run against this instance. For more detail, see influx config.

Step 5: Learn influx CLI commands

To see all available influx commands, type influx -h or check out influx - InfluxDB command line interface.

Step 1: Download influx CLI for Windows

Click the following button to download and install influx CLI for Windows.

influx CLI (Windows)

Step 2: Expand the downloaded archive

Expand the downloaded archive into C:\Program Files\InfluxData\influxdb.

Step 3: Grant network access

When using the influx CLI for the first time, Windows Defender will appear with the following message: Windows Defender Firewall has blocked some features of this app.

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

Step 4: Learn influx CLI commands

To see all available influx commands, type influx -h or check out influx - InfluxDB command line interface.