Create a bucket

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

Create a bucket in the InfluxDB UI

  1. Click the Organizations tab in the navigation bar.

  2. Click on the name of an organization, then select the Buckets tab.

  3. Click + Create Bucket in the upper right.

  4. Enter a Name for the bucket.

  5. Select How often to clear data?:
    Select Never to retain data forever.
    Select Periodically to define a specific retention policy.

  6. Click Create to create the bucket.

Create a bucket using the influx CLI

Use the influx bucket create command to create a new bucket. A bucket requires the following:

  • A name
  • The name or ID of the organization to which it belongs
  • A retention period in nanoseconds
# Pattern
influx bucket create -n <bucket-name> -o <org-name> -r <retention period in nanoseconds>

# Example
influx bucket create -n my-bucket -o my-org -r 604800000000000

Bug Reports and Feedback

Thank you for being willing to help test InfluxDB v2.0 alpha! Feedback and bug reports are welcome and encouraged both for InfluxDB and this documentation.

Submit feedback in the InfluxData Community