> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-en/productos/object-storage/quickstart.md).

# Quick Start

Create the repository with its quota and assign an owner user to it in two steps.

Setting up Object Storage takes two steps: you create the repository with its quota and assign it an owner user.

Connecting the software via S3 comes next, using the repository credentials.

> #### 📘 What you get
>
> An Object Storage repository created, with its quota and owner user, ready to connect via S3 or to start uploading objects from the dashboard.

### Before you begin

* Be signed in to the Plenit platform.
* Have an organization with at least one user, or create one during setup.

### Start setup

Depending on whether you already work with the service or it's your first time, you reach the wizard through one of these paths. All three end up in the same place.

| Situation                             | How you start                                                                                             |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| You already use Object Storage        | Go into the service and click **New subscription**, at the top right of the list                          |
| It's your first time with the service | On the product page, click **I want to try it now**                                                       |
| From a specific client                | Go into **Organization › Subscriptions** and choose **Object Storage** in "What do you want to register?" |

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-76347edc2ef7fd0f71debf0a49e55170bc89ea8c%2FListado_de_Servicios.png?alt=media" alt=""><figcaption><p><em>From the service list you can see the aggregated usage and create a new repository with New subscription, at the top right.</em></p></figcaption></figure>

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-bef62eafac48ea50dcc284ea70577d5ee20ee312%2FEmpty_state.png?alt=media" alt=""><figcaption><p><em>The first time, you enter the same wizard from the product page, with I want to try it now.</em></p></figcaption></figure>

### Step 1. Create the repository and set the quota

In the wizard:

1. Enter the **subscription name**, which will help you identify it.
2. Define the **storage quota** with the slider (from 100 GB). As you move it, you can see the estimated cost per month and per hour. You can increase it later if it grows.
3. Proceed to the next step.

> #### 📘 The name only allows letters and numbers
>
> Due to a service limitation, the repository identifier is made up only of letters and numbers, with no spaces, no uppercase letters, and no special characters.
>
> Keep this in mind when naming the subscription.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-19b4ae5cf978fcfc080ca13f1d79932edd3e8024%2FStep_1.png?alt=media" alt=""><figcaption><p><em>Step 1. Name the repository and set the quota with the slider (from 100 GB); you can increase it later if it grows.</em></p></figcaption></figure>

### Step 2. Assign the owner user

Select the user who will be **owner** of the repository. The owner has full permissions, and there can only be one per repository. If one doesn't exist, create it at that moment with **New user** and their email address. When you click **Save**, we create the repository.

> #### 📘 The rest of the users, later
>
> The other users who will access it are added after setup, with their specific permissions. You have it in [S3 access: users and credentials.](https://docs.plenit.com/docs-en/productos/object-storage/concepts/s3-access-users-and-credentials.md)

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-e8609ef9cc0451944389165e4479d6ef5a009685%2FStep_2.png?alt=media" alt=""><figcaption><p><em>Step 2. Choose the owner user of the repository, or create a new one on the spot.</em></p></figcaption></figure>

### Step 3. Check and collect the connection details

The repository appears as a **card in the dashboard**. When you enter, you have the service tabs (Summary, Bucket, Users, Structure) and the summary with the **usage** (quota, users, objects, and upload).

From the **Connect** button and from the **Users** tab you gather what you need to connect via S3: the endpoint, the repository name, and, in each user's access, the **access key** and the **secret key**.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-728067d25ab9785693d31f9735a6914413c6b633%2FSummary_1.png?alt=media" alt=""><figcaption><p><em>Once created, when you enter the repository you have the summary with the usage and the Connect button with the S3 connection details.</em></p></figcaption></figure>

### You already have the repository created

From here, the next step is to put it to work:

* Connect the software via S3 with commands or with a client: [How to integrate with an S3 client.](https://docs.plenit.com/docs-en/productos/object-storage/how-to/how-to-integrate-with-an-s3-client.md)
* Give access to the rest of the users and manage their keys: [S3 access: users and credentials.](https://docs.plenit.com/docs-en/productos/object-storage/concepts/s3-access-users-and-credentials.md)
* Enable version retention, from the tab **Bucket**: [Versioning and immutability.](https://docs.plenit.com/docs-en/productos/object-storage/details/versioning-and-immutability.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/docs-en/productos/object-storage/quickstart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
