---
title: "S3: Quick start"
sidebar_label: "Quick start"
sidebar_position: 2
description: "How to get started with S3: create a bucket, configure it, upload objects, and access the bucket"
---

import Formbricks from '@theme/MDXComponents/Formbricks'

# S3: Quick start

You can work with S3 in the [control panel](https://my.selectel.ru/storage/) and [via API](/api/).

1. [Create a bucket](#create-bucket).
2. Optional: [configure bucket access](#configure-access).
3. Optional: [set limits](#set-limits).
4. Optional: [select a tool to work with the storage](#choose-tool).
5. [Upload objects to the bucket](#upload-objects).

## 1. Create a bucket \{#create-bucket}

1. [Top up the balance](/balance-and-payments/manage/top-up-balance.mdx).

2. In the [control panel](https://my.selectel.ru/storage/), on the top menu, click **Products** and select **S3**.

3. Go to the **Buckets** section.

4. Click **Create bucket**.

5. Enter a bucket name. For S3 API compatibility, the bucket name must meet the following conditions:

   * be unique among the buckets of all users who use the storage via S3 API and are hosted in the same [pool](/infrastructure/locations.mdx#pool);
   * comply with Amazon S3 bucket naming rules — contain only digits, Latin letters, . and `-`; see [Bucket naming rules](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html) in the Amazon documentation for details.

6. Select the [region and pool](/infrastructure/locations.mdx) where the bucket will be created.

7. In the **Configuration** block:

   7.1. Select a bucket type:

   * private — for storing backups and other data with access via login and password or an authorization token;
   * public — for distributing content for a website or web application, accessible without authorization.

   7.2. Select a [storage class](/s3/about/payment.mdx#storage-types):

   * standard storage — for storing and distributing frequently accessed data;
   * infrequent access storage — for storing rarely accessed data;
   * glacier storage — for storing very rarely accessed data. Available only in the ru-3 pool.

   The storage class only affects the cost of resources; technically, the performance of all classes is the same. Once a bucket is created, the storage class cannot be changed.

   7.3. Select an [addressing type](/s3/buckets/addressing-types.mdx). We recommend choosing vHosted addressing for S3 API operations. You cannot change the addressing type to Path-Style after the bucket is created.

8. Optional: in the **Data Protection** block:

   8.1. To store previous [versions](/s3/buckets/versioning.mdx) of objects, enable versioning.

   8.2. To protect objects from deletion, enable Object Lock. Enabling [Object Lock](/s3/buckets/object-lock.mdx) does not lock objects automatically — you will be able to [manage object locking](/s3/objects/manage-object-lock.mdx) after the bucket is created. Object Lock requires versioning; if it is not enabled, it will be enabled automatically.

9. Click **Create bucket**.

## 2. Optional: configure bucket access \{#configure-access}

Learn more about access management in the [Managing S3 Access](/s3/manage/manage-access.mdx) guide.

1. [Add users](/access-control/manage/add-user.mdx) with the required [roles](/s3/manage/manage-access.mdx#access-within-roles).
2. Configure the [bucket policy](/s3/buckets/bucket-policy/).

## 3. Optional: set limits \{#set-limits}

You can set limits on the number of objects, the total size of objects, and specify an object retention period; see the [Bucket limits](/s3/buckets/limits.mdx) guide for details.

## 4. Optional: choose a tool for working with storage \{#choose-tool}

For ease of use and faster object uploads, configure [tools](/s3/tools/) — for example, the FTP protocol, Rclone client, AWS CLI, and others.

## 5. Upload objects \{#upload-objects}

Use the [Upload an object](/s3/objects/upload-object.mdx) guide.

<Formbricks />