---
title: influxdb3 update database
description: The influxdb3 update database command updates an existing database.
url: https://docs.influxdata.com/influxdb3/core/reference/cli/influxdb3/update/database/
estimated_tokens: 880
product: InfluxDB 3 Core
version: core
---

# influxdb3 update database

The `influxdb3 update database` command updates an existing database in your InfluxDB 3 Core instance.

InfluxDB 3 Core does not support updating database retention periods. Retention periods can only be set when [creating a database](/influxdb3/core/admin/databases/create/) and cannot be changed afterward.

## Usage

```bash
influxdb3 update database [OPTIONS] --database <DATABASE_NAME>
```

## Arguments

-   **`DATABASE_NAME`**: (Required) The name of the database to update.

You can also set the database name using the `INFLUXDB3_DATABASE_NAME` environment variable.

## Options

| Option |  | Description |
| --- | --- | --- |
| -H | --host | Host URL of the running InfluxDB 3 Core server (default is http://127.0.0.1:8181) |
| -d | --database | The name of the database to update |
|  | --token | Authentication token |
|  | --tls-ca | Path to a custom TLS certificate authority (for testing or self-signed certificates) |
|  | --tls-no-verify | Disable TLS certificate verification (Not recommended in production, useful for self-signed certificates) |
| -h | --help | Print help information |
|  | --help-all | Print detailed help information |

### Option environment variables

You can use the following environment variables instead of providing CLI options directly:

| Environment Variable | Option |
| --- | --- |
| INFLUXDB3_HOST_URL | --host |
| INFLUXDB3_DATABASE_NAME | --database |
| INFLUXDB3_AUTH_TOKEN | --token |
| INFLUXDB3_TLS_CA | --tls-ca |
| INFLUXDB3_TLS_NO_VERIFY | --tls-no-verify |