docs-v2/content/influxdb/v2/reference/cli/influx/v1/shell.md

title	description	menu	weight	influxdb/v2/tags	related	metadata
influx v1 shell	The `influx v1 shell` subcommand starts an InfluxQL shell (REPL).	influxdb_v2 name parent influx v1 shell influx v1	101	InfluxQL	/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials, influx CLI—Provide required authentication credentials /influxdb/v2/reference/cli/influx/#flag-patterns-and-conventions, influx CLI—Flag patterns and conventions /influxdb/v2/query-data/influxql/ /influxdb/v2/tools/influxql-shell/	influx CLI 2.4.0+ InfluxDB 2.0.1+

The influx v1 shell subcommand starts an InfluxQL shell (REPL).

{{% note %}}

Set up database and retention policy (DBRP) mapping

InfluxQL queries require a database and retention policy to query data. In InfluxDB {{% current-version %}}, databases and retention policies have been combined and replaced with buckets. To use the InfluxQL to query an InfluxDB {{% current-version %}} bucket, first map your DBRP combinations to an appropriate bucket. For more information, see Query data with InfluxQL.

{{% /note %}}

Usage

influx v1 shell [flags]

Flags

Flag		Description	Input type	{{< cli/mapped >}}
-c	--active-config	Config name to use for command	string	INFLUX_ACTIVE_CONFIG
	--configs-path	Path to the influx CLI configurations (default: ~/.influxdbv2/configs)	string	INFLUX_CONFIGS_PATH
	--host	HTTP address of InfluxDB	string	INFLUX_HOST
	--http-debug	Inspect communication with InfluxDB servers.
-o	--org	Organization name (mutually exclusive with --org-id)	string	INFLUX_ORG
	--org-id	Organization ID (mutually exclusive with --org)	string	INFLUX_ORG_ID
	--skip-verify	Skip TLS certificate verification		INFLUX_SKIP_VERIFY
-t	--token	API token	string	INFLUX_TOKEN

Examples

{{< cli/influx-creds-note >}}

Start an InfluxQL shell

influx v1 shell