influxdb3 create token --admin

Create an operator token or named admin token.

Usage

influxdb3 create token --admin [OPTIONS]

Options

Examples

• Create an operator token
• Use the operator token to create a named admin token
• Use the token to create a database
• Generate an offline admin token

Create an operator token

The operator token is a special token that has full administrative privileges on the InfluxDB server and doesn’t expire. The first admin token you create becomes the operator token for the instance. You can create an operator token using the --admin flag without any additional options.

influxdb3 create token --admin

The output is the raw token string you can use to authenticate future CLI commands and API requests. For CLI commands, use the --token option or the INFLUXDB3_AUTH_TOKEN environment variable to pass the token string.

Use the operator token to create a named admin token

influxdb3 create token \
  --admin \
  --token 
OPERATOR_TOKEN
 \
  --name 
TOKEN_NAME
 \
  --expiry DURATION 

Replace the following:

• OPERATOR_TOKEN: Your operator token for the server
• TOKEN_NAME: Name for your new admin token
• DURATION: Duration for the token to remain valid, in humantime format (for example, 10d for 10 days or 1y for 1 year).

Use the token to create a database

influxdb3 create database \
  --token ADMIN_TOKEN \
  
DATABASE_NAME

Replace the following:

• ADMIN_TOKEN: Your InfluxDB admin token
• DATABASE_NAME: Name for your new database

export INFLUXDB3_AUTH_TOKEN=ADMIN_TOKEN

Generate an offline admin token

Generate an offline admin token file to use if no tokens exist when the server starts. Once started, you can interact with the server using the provided token. Offline admin tokens are designed to help with automated deployments.

Include the following options:

• --offline (Required)
• --output-file (Required)
• --name (default is _admin)
• --expiry (Optional)

influxdb3 create token --admin \
  --name 
TOKEN_NAME
 \
  --expiry 
DURATION
 \
  --offline \
  --output-file 
path/to/admin-token.json

Replace the following:

• TOKEN_NAME: Name for your offline admin token
• DURATION: Duration for the token to remain valid, in humantime format (for example, 10d for 10 days or 1y for 1 year).
• path/to/admin-token.json: File path to use for the generated token file

{
  "token": "apiv3_0XXXX-xxxXxXxxxXX_OxxxX...",
  "name": "example-admin-token",
  "expiry_millis": 1756400061529
}