# Storage

SysEleven Object Storage provides S3-compatible storage with the following deployment options:

## Replicated Object Storage

- DUS2 (Düsseldorf - Master zone): `https://objectstorage-replicated.dus2.cloud.syseleven.net`
- HAM1 (Hamburg - Replicated zone): `https://objectstorage-replicated.ham1.cloud.syseleven.net`

Replicated Object Storage replicates data across regions, enhancing data durability and availability.

## Object Storage (non-geo-replicated, early access)

- DUS2 (Düsseldorf): `https://objectstorage.dus2.cloud.syseleven.net`

Object Storage keeps data within a single region while still benefiting from the resilience and redundancy provided by the underlying storage platform.

> [!TIP]
>
> **Attention**
>
> This is an Early Access offering which has limited functionality and|or warranty. Please refer to our common Terms and Conditions for details.

## Object Storage Setup and Configuration

We recommend using the MinIO Client (`mc`) to interact with SysEleven Object Storage. Please pay attention that you are able to use same credentials in both geo-replicated and non-geo-replicated endpoints. The following example uses the DUS2 geo-replicated endpoint.

1. Install the MinIO Client by following the [official MinIO Client documentation](<https://docs.min.io/aistor/reference/cli/#install-mc>).
2. Configure the MinIO Client with your Object Storage User credentials:

   ```bash
   unset HISTFILE
   mc alias set s11_dus2 https://objectstorage-replicated.dus2.cloud.syseleven.net ACCESS_KEY SECRET_KEY
   ```

Replace `ACCESS_KEY` and `SECRET_KEY` with your actual credentials, obtained from the [Object Storage User Management](<https://documentation.syseleven.de/en/products/iam/usage/s3-users/#create-s3-user-and-credentials>).

3. Test the connection:

   ```bash
   mc ls s11_dus2/
   ```

## Using Multiple Geo-replicated Regions

To use both geo-replicated regions, you can configure an additional alias:

```bash
mc alias set s11_ham1 https://objectstorage-replicated.ham1.cloud.syseleven.net ACCESS_KEY SECRET_KEY
```

You can then switch between regions using the `mc` command.

> [!TIP]
>
> **Temporary Aliases**
>
> You can set up temporary aliases for quick testing or scripting using environment variables. This method doesn't require modifying your `mc` configuration file.
>
> ```bash
> export MC_HOST_temp_dus2=https://ACCESS_KEY:SECRET_KEY@objectstorage-replicated.dus2.cloud.syseleven.net
> mc ls temp_dus2/
> ```
>
> Replace `ACCESS_KEY` and `SECRET_KEY` with your actual credentials. This creates a temporary alias `temp_dus2` that you can use with `mc` commands.
