NAME

influx - InfluxDB client

SYNOPSIS

influx [options]
influx -execute <command> [options]
influx -import -path <path> (-compressed) [options]
influx -version

DESCRIPTION

influx is the command line program for interacting with an InfluxDB server.

In the first form, the program starts a CLI that can be used to write data or query the database. The command line is described in COMMAND LINE.

In the second form, this will execute a single command, usually a query. This is the equivalent of starting the command line, running one command, and then exiting.

In the third form, this imports a previously exported database to the database.

The fourth form outputs the version of the command line and then immediately exits.

OPTIONS

-host <host>

Host to connect to. Default is localhost.

-port <port>

Port to use when connecting to the host. Default is 8086.

-database <database>

Database to use when connecting to the database.

-username <username>

Username to connect to the server.

-password <password>

Password to connect to the server. If left blank, this will prompt for a password.

-ssl: Use https for requests.

-unsafeSsl

Set this with -ssl to allow unsafe connections.

-execute <command>

Executes the command and exits.

-format <json|csv|column>

Sets the format of the server responses. Default is column.

-precision <rfc3339|h|m|s|ms|u|ns>

Specifies the format of the timestamp. Default is ns.

-consistency <any|one|quorum|all>

Set the write consistency level. Default is one.

-pretty

Turns on pretty print format for the JSON format.

-node <n>

Specifies the data node that should be queried for data. This option is only valid on enterprise clusters.

-import

Import a previous database export from a file. If specified, -path <path> must also be specified.

-path <path>

Path to the database export file to import. Must be used with -import.

-pps <n>: How many points per second the import will allow. By default, it is zero and will not throttle importing.

-compressed

Set if the import file is compressed. Must be used with -import.

-version

Outputs the version of the influx client.

ENVIRONMENT

The environment variables can be specified in lower case or upper case. The upper case version has precedence.

HTTP_PROXY [protocol://]<host>[:port]

Sets the proxy server to use for HTTP.

HTTPS_PROXY [protocol://]<host>[:port]

Sets the proxy server to use for HTTPS. Takes precedence over HTTP_PROXY for HTTPS.

NO_PROXY <comma-separated list of hosts>

List of host names that shouldn’t go through any proxy. If set to an asterisk '*' only, it matches all hosts.

BUGS

Report bugs to the GitHub issue tracker https://github.com/influxdata/influxdb.

AUTHORS

InfluxDB is written and maintained by InfluxData https://influxdata.com.

COPYRIGHT

InfluxDB is released under the MIT license.

This man page is released under Creative Commons Attribution 4.0 International License.