> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/get-started/create-bucket.md).

# Create a Bucket

When creating a bucket, you must carefully consider the following settings:

* The [<mark style="color:blue;">Bucket Types</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/concepts/bucket-types.md).
* Supported [<mark style="color:blue;">service availability</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/overview.md#service-availability) S3 regions.
* To enable [<mark style="color:blue;">Object Lock</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/settings/object-lock.md) or not for the bucket.

The Object Storage bucket can be created through one of the following methods:

* [<mark style="color:blue;">DCD</mark>](#dcd)
* [<mark style="color:blue;">IONOS S3 Object Storage API</mark>](#ionos-s3-object-storage-api)
* [<mark style="color:blue;">CLI</mark>](#cli-tool)

## DCD

The easiest way to create a bucket is by using the DCD. You must create a bucket before you can start uploading objects to the Object Storage.

You can create either a contract-owned bucket or a user-owned bucket but the shift towards a contract-owned bucket model will be the primary focus for future Object Storage updates.

{% tabs %}
{% tab title="Contract-owned Buckets" %}
To create a contract-owned bucket, follow these steps:

{% hint style="info" %}
**Prerequisites:**

* Make sure you have the corresponding permission to create the Object Storage. Only a contract owner or an administrator can create contract-owned buckets.
* You must have at least one active access key; otherwise, [<mark style="color:blue;">Generate a Key</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/get-started/generate-key.md) or [<mark style="color:blue;">activate</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/how-tos/manage-keys.md#activate-or-deactivate-a-key) an existing access key.
  {% endhint %}

1\. In the **DCD**, go to **Menu** > **Storage** > **IONOS S3 Object Storage**.

2\. In the **Buckets** tab, click **Create a bucket**.

3\. Choose the **Bucket region** which determines the geographical location where the data inside the buckets will be stored. Currently, you can create contract-owned buckets only in the `eu-central-3` S3 region.

3\. Enter a unique name for the **Bucket name** that adheres to the [<mark style="color:blue;">naming conventions</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/concepts/buckets.md#naming-conventions) for a bucket.

{% hint style="warning" %}
**Note:** A bucket will not be created if a bucket with the same name already exists in the IONOS S3 Object Storage.
{% endhint %}

4\. *(Optional)* Choose whether you want to enable the Object Lock for the bucket. If yes, then select the **Enable Object Lock** checkbox.

5\. If the Object Lock is enabled, select the mode of Object Lock to apply on the objects uploaded to the bucket. Choose from the **Governance mode** or **Compliance mode** and input the **Retention period** in days or years. For more information, see [<mark style="color:blue;">Modes</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/settings/object-lock.md#modes).

![Object lock](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-652e8214703029a0e3abdb95f7c3f9dccbfc8c86%2Fs3-object-lock.png?alt=media)

{% hint style="info" %}
**Note:** When enabling Object Lock, [<mark style="color:blue;">Versioning</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/settings/versioning.md) is enabled for the bucket by default.
{% endhint %}

6\. Click **Create bucket**.

{% hint style="success" %}
**Result:** A contract-owned bucket is created in the `eu-central-3` S3 region.
{% endhint %}
{% endtab %}

{% tab title="User-owned Buckets" %}
To create a user-owned bucket, follow these steps:

{% hint style="info" %}
**Prerequisite:** You must have at least one active access key; otherwise, [<mark style="color:blue;">Generate a Key</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/get-started/generate-key.md) or [<mark style="color:blue;">activate</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/how-tos/manage-keys.md#activate-or-deactivate-a-key) an existing access key.
{% endhint %}

1\. In the **DCD**, go to **Menu** > **Storage** > **IONOS S3 Object Storage**.

2\. In the **Buckets** tab, click **Create a bucket**.

3\. Choose the **Bucket region** which determines the geographical location where the data inside the buckets will be stored. You can create user-owned buckets in any of these S3 regions: `de`, `eu-central-2`, and `eu-south-2` S3 regions.

3\. Enter a unique name for the **Bucket name** that adheres to the [<mark style="color:blue;">naming conventions</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/concepts/buckets.md#naming-conventions) for a bucket.

{% hint style="warning" %}
**Note:** A bucket will not be created if a bucket with the same name already exists in the IONOS S3 Object Storage.
{% endhint %}

4\. *(Optional)* Choose whether you want to enable the Object Lock for the bucket. If yes, then select the **Enable Object Lock** checkbox.

5\. If the Object Lock is enabled, select the mode of Object Lock to apply on the objects uploaded to the bucket. Choose from the **Governance mode** or **Compliance mode** and input the **Retention period** in days or years. For more information, see [<mark style="color:blue;">Modes</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/settings/object-lock.md#modes).

![Object lock](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-652e8214703029a0e3abdb95f7c3f9dccbfc8c86%2Fs3-object-lock.png?alt=media)

{% hint style="info" %}
**Note:** When enabling Object Lock, [<mark style="color:blue;">Versioning</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/settings/versioning.md) is enabled for the bucket by default.
{% endhint %}

6\. Click **Create bucket**.

{% hint style="success" %}
**Result:** A user-owned bucket is created in the selected S3 region.
{% endhint %}
{% endtab %}
{% endtabs %}

## IONOS S3 Object Storage API

Using the [<mark style="color:blue;">Create Bucket</mark>](https://api.ionos.com/docs/s3/v2/#tag/Basic-Operations/operation/CreateBucket) API operation, you can create a bucket with or without the object lock.

## CLI tool

For details on configuring the AWS CLI tool, see [<mark style="color:blue;">AWS CLI</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/s3-tools/awscli.md).

{% tabs %}
{% tab title="Contract-owned Buckets" %}

#### To create a bucket without an Object Lock

**In the `eu-central-3` region (Berlin, Germany):**

```
aws s3 mb s3://my-bucket --region eu-central-3 --endpoint-url https://s3.eu-central-3.ionoscloud.com
```

#### To create a bucket with an Object Lock:

**In the `eu-central-3` region (Berlin, Germany):**

```
aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-central-3 --endpoint-url https://s3.eu-central-3.ionoscloud.com
```

{% endtab %}

{% tab title="User-owned Buckets" %}

#### To create a bucket without an Object Lock

* **In the `de` region (Franfurt, Germany):**

```
aws s3 mb s3://my-bucket --region de --endpoint-url https://s3.eu-central-1.ionoscloud.com
```

* **In the `eu-central-2` region (Berlin, Germany):**

```
aws s3 mb s3://my-bucket --region eu-central-2 --endpoint-url https://s3.eu-central-2.ionoscloud.com
```

* **In the `eu-south-2` region (Logrono, Spain):**

```
aws s3 mb s3://my-bucket --region eu-south-2 --endpoint-url https://s3.eu-south-2.ionoscloud.com
```

#### To create a bucket with an Object Lock

* **In the `de` region (Franfurt, Germany):**

```
aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region de --endpoint-url https://s3.eu-central-1.ionoscloud.com
```

* **In the `eu-central-2` region (Berlin, Germany):**

```
aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-central-2 --endpoint-url https://s3.eu-central-2.ionoscloud.com
```

* **In the `eu-south-2` region (Logrono, Spain):**

```
aws s3 mb s3://my-bucket --object-lock-enabled-for-bucket --region eu-south-2 --endpoint-url https://s3.eu-south-2.ionoscloud.com
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/storage-and-backup/s3-object-storage/get-started/create-bucket.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.