> For the complete documentation index, see [llms.txt](https://docs.nodeum.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nodeum.io/data-mover/console/storage-services/object-storage-configuration.md).

# Object Storage Configuration

Multiple S3 compatible Cloud and Object Storage providers are supported  :

Public cloud providers :

* Amazon AWS S3 Storage
* Google Cloud Storage
* Microsoft Azure Blob Storage
* Wasabi Hot Cloud Storage

Private Cloud Providers :

* Cloudian HyperStore
* Dell EMC ECS
* OpenStack Swift
* Quantum ActiveScale
* Scality Ring
*

Generic

* Generic S3

{% hint style="warning" %}
If you don't find your S3 storage in this list, there is also a "Generic" S3 connector which is available.
{% endhint %}

## S3 Storage

### Configuration

Navigate to 

> Storage Services -> Connector-> Cloud

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FcMFsmOvCNcV3cSOS6HaM%2Fimage.png?alt=media&amp;token=c424956c-f776-4c52-9306-2f1924d47f29" alt=""><figcaption></figcaption></figure>

* [ ] To connect to a new S3 Storage, click the button&#x20;

<div align="center"><figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FN1Kt4aG47e0yu8kCNXur%2Fimage.png?alt=media&amp;token=e646fa36-437c-41c9-a237-08a6760ac25f" alt="" width="33"><figcaption></figcaption></figure></div>

* [ ] Fill the following parameters to configure the storage :&#x20;

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2Fk4GbDJCqL8yloRjFgRoQ%2Fimage.png?alt=media&amp;token=657508e1-14e3-48cc-b083-20feada18197" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="260"></th><th></th></tr></thead><tbody><tr><td><strong>Parameters</strong></td><td><strong>Definition</strong></td></tr><tr><td>Name</td><td>Complete the name of the storage</td></tr><tr><td>Provider</td><td>Choose a provider</td></tr><tr><td>Region</td><td>Complete the region*</td></tr><tr><td>URL</td><td>Complete the url</td></tr><tr><td>Backend</td><td>Select the backend : Rclone or S3FS</td></tr><tr><td>Mount Options</td><td></td></tr><tr><td>Access Key ID</td><td>Complete*</td></tr><tr><td>Secret access key</td><td>Complete*</td></tr></tbody></table>

{% hint style="info" %}
\*Information required, if your provider doesn't enforce the usage of region, define a value representative for you.
{% endhint %}

The name of a cloud storage is unique.  You can't have several cloud storage with the same Name.

Once, the connector is defined, the buckets will automatically appear.

## Swift Storage

#### OpenStack Swift Configuration

> Storage Services -> Connector-> Cloud

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FDHiWhub59uPYnM4D5WlU%2Fimage.png?alt=media&amp;token=741cb9fc-e615-416f-a051-43798777c401" alt=""><figcaption></figcaption></figure>

* [ ] To create a new storage "OpenStack Swift" click on the button&#x20;

<div align="left"><figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FN1Kt4aG47e0yu8kCNXur%2Fimage.png?alt=media&amp;token=e646fa36-437c-41c9-a237-08a6760ac25f" alt="" width="33"><figcaption></figcaption></figure></div>

* [ ] and complete the form

&#x20;

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2F0JNEDYQ1g4MDqy52jEho%2Fimage.png?alt=media&amp;token=44a8c129-8341-4bcb-aa33-8b3a4451585d" alt="" width="257"><figcaption></figcaption></figure>

\-         **Name:** complete the name you define in the toml (ansible playbook)

{% hint style="warning" %}
Mandatory to have the same name as the name writing in the toml (parent\_name)
{% endhint %}

\-         **Provider:** choose OpenStack Swift <mark style="background-color:red;">(</mark><mark style="background-color:red;">**+++ Mandatory**</mark><mark style="background-color:red;">)</mark>

### How to Visualize your buckets ?

Go to&#x20;

> Storage Services -> Cloud

&#x20;At this stage, This panel display the complete overview of all Cloud Bucket.

You directly see if the bucket is Online or Offline.


---

# 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.nodeum.io/data-mover/console/storage-services/object-storage-configuration.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.