Create your first Object Storage bucket and upload an object

Prerequisites

• A STACKIT customer account: Create a customer account
• A STACKIT project: Create a project
• AWS CLI installed: Set up the AWS CLI

Enable Object Storage

1. In the STACKIT Portal, open your project.
2. In the sidebar, select Object Storage - Overview.
3. Select Enable Object Storage.

Object Storage is now enabled in your project. You can start creating buckets and managing credentials.

Create credentials

1. In the STACKIT Portal, open your project.
2. In the sidebar, select Object Storage - Credentials & Groups.
3. Select an existing credential group to open its General information view.
4. In the navigation bar on the right, select the Credentials tab.
5. Select Create credentials.
6. A dialog opens showing your new Access key ID and Secret access key.
7. Save both values now.

You can not retrieve the Secret access key again after closing the dialog. Store it in a secure location immediately.

Your credentials appear in the credentials list.

Installation

Download the latest release for your platform from the GitHub repository.

Linux

Unpack the downloaded archive and move the runnable file to /usr/local/bin:

mv s5cmd /usr/local/bin/

For Debian-based distributions, install the .deb package directly with dpkg:

dpkg -i s5cmd_2.3.0_linux_amd64.deb

macOS

Install with Homebrew:

brew install peak/tap/s5cmd

Windows

Unpack the downloaded archive and place the .exe file in a directory that is in your system path.

Configuration

Set the required environment variables so s5cmd can connect to your STACKIT Object Storage endpoint.

Linux and macOS

export S3_ENDPOINT_URL="https://object.storage.eu01.onstackit.cloud"
export AWS_ACCESS_KEY_ID="xxxxxxxxxxxx" export AWS_SECRET_ACCESS_KEY="yyyyyyyyyyyyyyyyyyyyyy"
export AWS_REGION="eu01"

Windows

setx S3_ENDPOINT_URL "https://object.storage.eu01.onstackit.cloud"
setx AWS_ACCESS_KEY_ID "xxxxxxxxxxxx"
setx AWS_SECRET_ACCESS_KEY "yyyyyyyyyyyyyyyyyyyyyy"
setx AWS_REGION "eu01"

Create a bucket

aws s3 mb s3://my-first-bucket \
  --endpoint-url https://object.storage.eu01.onstackit.cloud

The output confirms the creation:

make_bucket: my-first-bucket

Upload your first object

Create a small test file and upload it to your bucket. Replace my-first-bucket with your actual bucket name:

echo "Hello Object Storage" > hello.txt
aws s3 cp hello.txt s3://my-first-bucket/ \
  --endpoint-url https://object.storage.eu01.onstackit.cloud

The endpoint domain varies by region. The example above uses the eu01 region. Check the Object Storage settings in the STACKIT Portal to find the correct endpoint for your region.

The output confirms the upload:

upload: ./hello.txt to s3://my-first-bucket/hello.txt

Verify the upload

List the contents of your bucket to confirm the object was stored:

aws s3 ls s3://my-first-bucket/ \
  --endpoint-url https://object.storage.eu01.onstackit.cloud

The output shows your uploaded file:

2024-01-01 10:00:00         21 hello.txt

Your Object Storage bucket is now set up and contains your first object. Continue with the How-tos to manage all features in detail.