> 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-archiving/console/system-settings/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&#x20;

> System -> Hardware -> Storage -> Cloud&#x20;

<figure><img src="/files/Ttsvx8N4twYSIAjLvc0o" alt=""><figcaption></figcaption></figure>

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

<div align="center"><figure><img src="/files/rlndNmGZP41H4VFvabTl" alt="" width="33"><figcaption></figcaption></figure></div>

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

<figure><img src="/files/6VTyKPlXmI7vTaocONTC" 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

> System -> Hardware -> Storages -> Cloud

<figure><img src="/files/Nrp3BMLZGRSnyyrlvPH4" alt=""><figcaption></figcaption></figure>

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

<div align="left"><figure><img src="/files/rlndNmGZP41H4VFvabTl" alt="" width="33"><figcaption></figcaption></figure></div>

* [ ] and complete the form

&#x20;

<figure><img src="/files/sERhC4KWyOAY9n2PGfpQ" 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.

### S3 As a Primary Storage

Primary Storage need to be mount before launching a task.&#x20;

To mount the storage, click on the button to connect the storage.

If you change the Backend for a primary storage bucket, it's required to reconnect the Storage (in the Storage Services cloud), for doing this operation, alt click on the button:

It's required to reconnect the Storage (in the Storage Services cloud), for doing this operation, alt click on the button:

![](https://www.nodeum.io/hs-fs/hubfs/image-png-Feb-15-2022-01-58-40-22-PM.png?width=70\&name=image-png-Feb-15-2022-01-58-40-22-PM.png)

### S3 As a Secondary Storage

Secondary storage are automatically mounted by the workflow manager.

If you change the Backend for a Secondary storage bucket, it's required to restart the service Core Manager (in settings menu).


---

# 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:

```
GET https://docs.nodeum.io/data-archiving/console/system-settings/object-storage-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
