---
title: Update a bucket
description: Update a bucket’s name or retention period in InfluxDB using the InfluxDB UI or the influx CLI.
url: https://docs.influxdata.com/influxdb/v2/admin/buckets/update-bucket/
estimated_tokens: 1580
product: InfluxDB OSS v2
version: v2
---

# Update a bucket

This page documents an earlier version of InfluxDB OSS. [InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a copy of the database file doesn’t expose usable tokens. Existing tokens are hashed on first startup and the original strings can’t be recovered afterward — **capture any plaintext tokens you still need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

Use the `influx` command line interface (CLI) or the InfluxDB user interface (UI) to update a bucket.

Note that updating an bucket’s name will affect any assets that reference the bucket by name, including the following:

-   Queries
-   Dashboards
-   Tasks
-   Telegraf configurations
-   Templates

If you change a bucket name, be sure to update the bucket in the above places as well.

## Update a bucket’s name in the InfluxDB UI

1. In the navigation menu on the left, select **Data (Load Data)** > **Buckets**.
    
    Load Data
    
2. Click **Settings** under the bucket you want to rename.
    
3. Click **Rename**.
    
4. Review the information in the window that appears and click **I understand, let’s rename my bucket**.
    
5. Update the bucket’s name and click **Change Bucket Name**.
    

For information about permitted bucket names, see [bucket naming restrictions](/influxdb/cloud/admin/buckets/create-bucket/#bucket-naming-restrictions).

## Update a bucket’s retention period in the InfluxDB UI

1. In the navigation menu on the left, select **Data (Load Data)** > **Buckets**.
    
    Load Data
    
2. Click **Settings** next to the bucket you want to update.
    
3. In the window that appears, edit the bucket’s retention period.
    
4. Click **Save Changes**.
    

## Update a bucket using the influx CLI

Use the [`influx bucket update` command](/influxdb/v2/reference/cli/influx/bucket/update) to update a bucket. Updating a bucket requires the following:

-   The bucket ID *(provided in the output of `influx bucket list`)*
-   The name or ID of the organization the bucket belongs to.

#### Authentication credentials

The examples below assume your InfluxDB **host**, **organization**, and **token** are provided by either the [active `influx` CLI configuration](/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials) or by environment variables (`INFLUX_HOST`, `INFLUX_ORG`, and `INFLUX_TOKEN`). If you do not have a CLI configuration set up or the environment variables set, include these required credentials for each command with the following flags:

-   `--host`: [InfluxDB host](/influxdb/v2/reference/urls/)
-   `-o, --org` or `--org-id`: InfluxDB organization name or ID
-   `-t, --token`: InfluxDB API token

##### Update the name of a bucket

For information about permitted bucket names, see [bucket naming restrictions](/influxdb/cloud/admin/buckets/create-bucket/#bucket-naming-restrictions).

```sh
# Syntax
influx bucket update -i <bucket-id> -n <new-bucket-name>

# Example
influx bucket update -i 034ad714fdd6f000 -n my-new-bucket
```

##### Update a bucket’s retention period

Valid retention period duration units:

-   nanoseconds (`ns`)
-   microseconds (`us` or `µs`)
-   milliseconds (`ms`)
-   seconds (`s`)
-   minutes (`m`)
-   hours (`h`)
-   days (`d`)
-   weeks (`w`)

The minimum retention period is **one hour**.

```sh
# Syntax
influx bucket update -i <bucket-id> -r <retention period with units>

# Example
influx bucket update -i 034ad714fdd6f000 -r 1209600000000000ns
```