How to Set Up and Use S3 Storage Client Tools

S3 Storage is compatible with various client tools, including S3CMD, CyberDuck (available for Mac & Windows), and S3 Browser (for Windows).

To get started, you need to:

Install the client tool on your computer or server.
Create an account and set up a bucket on the ServerOptima Dashboard.
Obtain the Access Key and Secret Key for the bucket.

Step 1: Obtain Access Key and Secret Key

Visit https://my.serveroptima.com/clientarea/ to retrieve your Access Key and Secret Key.

Step 2: Configure the tools according to the information below.

1. Tool S3CMD (command line for linux/unix)

Setup:

CentOS/RHEL:

sudo yum install s3cmd -y

Ubuntu/Debian:

sudo apt-get install s3cmd

MacOS:

brew install s3cmd

Edit config: ~/.s3cfg

sudo vim ~/.s3cfg

[default]
access_key = your_storage_access_key
secret_key = your_storage_private_key
check_ssl_certificate = True
guess_mime_type = True
host_base = s3.serveroptima.com
host_bucket = s3.serveroptima.com
use_https = True

Some basic command:

List all bucket

s3cmd ls

create a new bucket with the following command. Replace the example-bucket with whatever you want to name your bucket.

s3cmd mb s3://example-bucket

Bucket 's3://example-bucket/' created

Once you’ve created a bucket, you can confirm it by listing the buckets in your Object Storage.

s3cmd ls

If you want to remove a certain bucket, you can delete it by using the following command.

s3cmd rb s3://example-bucket

Bucket 's3://example-bucket/' removed

See more at https://s3tools.org/usage

2. Cyberduck:

Download and setup https://cyberduck.io/download/

Install the App Based on the Version You Downloaded:

– For Mac users: Place the Cyberduck.app file in your Applications folder.
– For Windows users: Follow the installation wizard prompts to install it.

Create a Connection:

- Open the Cyberduck app.

- Click on the "Open Connection" button in the toolbar (see Figure 3).

Create a Configuration File:

- Use a text editor to create a configuration file named s3serveroptima.cyberduckprofile (the name can be anything but must have the .cyberduckprofile extension) with the following content:



	
		Protocol
		s3
		Vendor
		s3-path-style
		Scheme
		https
		Description
		S3 (S3 ServerOptima)
		Hostname Configurable
		
		Port Configurable
		
		Username Configurable
		
		Properties
		
			s3.bucket.virtualhost.disable=true

Save the file.

Run the Configuration File:

- Double-click the s3serveroptima.cyberduckprofile file.

- In the Cyberduck interface, select "Open Connection."

Click "Connect" to initiate the connection to the server. When prompted, enter your Access Key and Secret Key to log in.

After successfully connecting, the cyberduck interface will display the buckets in the account. You can download, upload, create new...folders and files.

The downloaded folder and files are located in the Downloads folder of the user running cyberduck.

3. S3 Browser

S3 Browser is a freeware Windows client for S3-compatible object storage. This guide explains how to configure a connection to Vultr Object Storage. To follow these steps, you will need a Server Optima Cloud Storage subscription and a Windows workstation.

Install and Add a Subscription

Download S3 Browser and run installer

- Launch S3 Browser.

- Click Accounts -> Add New Account.

- Enter an account name.

- Choose S3 Compatible Storage for Account Type.

- Enter s3.serveroptima.com:443

- Enter your Access Key ID and Secret Access Key. You'll find these values in your Object Storage subscription.

- Click the Add new account button.

S3 Browser should connect to your ServerOptima subscription and display your buckets.

Manage File Permissions

Files on ServerOptima Storage are private by default. You can enable public access to files one at a time or in batches.

- Select one or more files, then click the Permissions tab.

- Click Make Public or Make Private.

- Click the Copy button to copy the public URL to your clipboard.

For more information about using S3 Browser, see the official documentation.