Skip to content

API Access — Object Storage

SysEleven Object Storage provides S3-compatible storage in two distinct regions:

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

Both regions offer replicated storage, enhancing data durability and availability. You can choose to use either region based on your specific needs, such as geographical proximity or data redundancy requirements.

SysEleven Object Storage Setup and Configuration

We recommend using the MinIO Client (mc) to interact with SysEleven Object Storage. This example will use the DUS2 (Düsseldorf) region.

  1. Install the MinIO Client by following the official MinIO Client documentation.

  2. Configure the MinIO Client with your SysEleven Object Storage User credentials:

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 SysEleven Object Storage User Management.

  1. Test the connection:
mc ls s11_dus2/

Using Multiple Regions

If you want to use both regions, you can set up additional aliases:

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:

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.

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.