---
title: influxdb3 CLI
description: The influxdb3 CLI writes and queries data and administers your InfluxDB 3 Cloud instance from the command line.
url: https://docs.influxdata.com/influxdb3/cloud/reference/cli/influxdb3/
estimated_tokens: 402
product: InfluxDB 3 Cloud
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud/reference/cli/influxdb3/
date: '2026-07-16T22:25:37-05:00'
lastmod: '2026-07-16T22:25:37-05:00'
---

The `influxdb3` CLI writes and queries data and administers your
InfluxDB 3 Cloud instance from the command line.
Because InfluxDB 3 Cloud is fully managed, the CLI connects to your hosted
instance instead of running a local server.

## Connect and authenticate

The CLI connects to `http://127.0.0.1:8181` by default. Before you run commands,
set your instance host and authenticate:

* **Host**: Set the `INFLUXDB3_HOST_URL` environment variable, or pass `--host`,
  to your instance host URL.
* **Authentication**:
  * For interactive use, log in with the OAuth device-code flow:`influxdb3 auth login --oauth`. Don’t set `INFLUXDB3_AUTH_TOKEN` for
    interactive use.
  * For applications and automated clients, use a database token: set the`INFLUXDB3_AUTH_TOKEN` environment variable, or pass `--token`.

For setup steps, see[Set up InfluxDB 3 Cloud](/influxdb3/cloud/get-started/setup/#configure-the-influxdb3-cli).

## Commonly used commands

* `influxdb3 create database`: Create a database
* `influxdb3 create token --admin`: Create a named admin token
* `influxdb3 create token --permission`: Create a scoped database token
* `influxdb3 show tokens`: List tokens
* `influxdb3 delete token`: Delete a token
* `influxdb3 write`: Write data to a database
* `influxdb3 query`: Query data in a database

InfluxDB 3 Cloud runs the same InfluxDB 3 engine as InfluxDB 3 Enterprise,
so the `influxdb3` CLI works the same way. Server-management commands like`serve` don’t apply, because InfluxData runs the server for you.

#### Related

* [Set up InfluxDB 3 Cloud](/influxdb3/cloud/get-started/setup/)