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 Settings tab in the navigation bar.

  2. 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