How to use S3 storage?

You can store files in S3 cloud storage. To get started, you will need additional software — an S3 client.

Getting Started

To begin using the storage, create an S3 user or access credentials in your user account.

Creating an S3 user and Connection Credentials:

1. Navigate to S3 User Management to create a new user.

   • Specify the S3 ID and User Name (you can choose any name).

   • Once the user is created, the Access Key and Secret Key will be generated and displayed.

2. Go to Login Credentials to generate login details.

   • All fields will be filled in automatically; simply save the credentials.

   • The Access and Secret keys will also be available there.

3. Use any S3 client to connect to S3 storage, such as S3 Browser.

Setting Up S3 Browser

Follow these steps to configure the S3 Browser:

1. Open the Accounts menu and select Add New Account.

2. Fill out the fields on the "New User" page:

   • Display Name: Enter any name (this is for local display only).

   • Account Type: Choose "S3 Compatible Storage."

   • REST Endpoint: Enter https://api.immers.cloud:8080.

   • Access Key ID: Use the Access Key from the S3 user details.

   • Secret Access Key: Use the Secret Key from the S3 user details.

   • Advanced Settings:

     • Set the Addressing Model to Path Style.

     • Save the configuration.

3. Click Next, then Add New Account.

Your account is now ready. You can create buckets (referred to as "baskets" in the interface) and upload files.

Managing Buckets

• Buckets are displayed on the website in the Buckets Section.

• You can monitor your bucket activity in the Bucket Operations Section.

Configuring s3cmd for S3 access

At this stage, you should already have an Access key and a Secret key.

1. Run s3cmd --configure
2. Enter your key values:

• Access key
• Secret key
• S3 Endpoint: api.immers.cloud:8080
• DNS-style bucket+hostname:port template for accessing a bucket: %.api.immers.cloud:8080
• Use HTTPS protocol [Yes]: Yes
• You can leave the remaining parameters at their default values; save the configuration.

List of basic s3cmd commands:

• Create a new bucket named test1: s3cmd mb s3://test (the name must consist of lowercase letters)
• List existing buckets: s3cmd ls
• Upload an arbitrary file to a bucket: s3cmd put file.zip s3://test/file.zip
• View information about a bucket or object: s3cmd info s3://test/file.zip
• Check the size of a bucket or object: s3cmd du s3://test/file.zip
• Delete an object (file) from a bucket: s3cmd rm s3://test/file.zip
• Delete a bucket along with its contents: s3cmd rb s3://test -r