# Getting Started

This getting-started guide provides a concise introduction to Object Storage. It covers the essential operations of creating a bucket and uploading a file using the MinIO Client (`mc`).

## Prerequisites

- Access to the Object Storage service
- An Object Storage user with access credentials (Access Key and Secret Key)
- MinIO Client (`mc`) installed and configured

For detailed setup instructions, including how to create an Object Storage user and configure the MinIO Client, see the [API Access — Object Storage](<https://documentation.syseleven.de/en/discover/apis-and-regions/object-storage/index.md>) guide.

## Step 1: Create a Bucket

Create a bucket to store your objects:

```bash
mc mb s11_dus2/my-first-bucket
```

Replace `my-first-bucket` with a unique name for your bucket.

## Step 2: Upload a File

Upload a file to your new bucket:

```bash
echo "Hello, Object Storage!" > test.txt
mc cp test.txt s11_dus2/my-first-bucket/
```

Verify the upload by listing the bucket contents:

```bash
mc ls s11_dus2/my-first-bucket/
```

You should see `test.txt` in the output.

> [!TIP]
>
> **Using Other S3-Compatible Tools**
>
> This guide uses the MinIO Client, but you can use any S3-compatible tool or library to interact with Object Storage. Be sure to use the correct endpoint URL for your chosen region.

## Next Steps

You've created a bucket and uploaded a file to Object Storage. To learn more about advanced features and best practices, see the [Usage Guides](<https://documentation.syseleven.de/en/products/object-storage/usage/buckets/index.md>) and [Concepts](<https://documentation.syseleven.de/en/products/object-storage/concepts/index.md>) documentation.
