Connecting to Amazon S3 compatible Storage. How to work with storage providers using the Amazon S3 compatible API. Working with AWS-Compatible Cloud Hosting.

How to Connect to Amazon S3 compatible Storage:

Start CS Browser and choose Accounts, Add new account.
Choose Accounts, Add new account, or press Ctrl+Alt+N.
The Add New Account dialog will open:
Add New Account dialog.
Choose Amazon S3 Compatible Storage as the account type.
Specify the API Endpoint - an address that is used to send API calls to the storage. Please check the storage documentation or contact the storage support to find the API endpoint address.
Specify Access Key ID and Secret Access Key - access keys can be found in your storage profile. Please check the storage documentation or contact storage support if you have difficulties obtaining your access keys.
Enable Encrypt Access Keys with a password to use your own master password instead of the built-in application key. CS Browser will prompt for it whenever it needs to unlock this account.
Turn on Use secure transfer (SSL/TLS) if you would like to encrypt all communications with the storage.
Click Add new account.
You can now choose the newly added account from the Accounts menu:
Select the newly added account from the Accounts menu, or use the shortcut shown next to it.

Advanced Amazon S3 compatible Storage Settings

You may also need to configure additional settings to connect to Amazon S3 compatible storage, for example the Signature Version or the Addressing Model.

By default, the Path-style addressing model and Signature Version 4 are used.

To modify these settings, click the advanced settings link located at the bottom-left corner of the Add New Account or Edit Account dialog. For an existing account, choose Accounts, Manage accounts, select the account, and click Edit first.

The Advanced Amazon S3 compatible Storage Settings dialog will open:

You can configure the following settings here:

General

Signature version - select the version supported by your provider. The default is Signature V4.

Addressing model - Path style is selected by default. Select Virtual hosted style if required by your provider.

Regions and Storage classes display a summary of the account's configuration. Click the corresponding summary or pencil button to open its editor.

Regions

On the General tab, click the pencil button next to Regions. The Regions dialog will open:

Override storage regions - enable this option and enter one region per line in the format Region Name=region-code. Use region codes supported by your provider; the screenshot shows examples. For multiple regions, the storage must support the Amazon S3 compatible GetBucketLocation API call.

Region-specific endpoint (optional) - specify a region-specific endpoint template for your Amazon S3 compatible storage. The {region-code} variable can be used as the placeholder for the region code.

If Version 4 is selected for the Signature and the s3:GetBucketLocation API call is supported by the storage, the {region-code} variable will be replaced with the region code returned by this call, resulting in the construction of a region-specific endpoint and allowing you to avoid region-specific redirects and extra requests.

Click OK to return to General. For a provider-specific example, see connecting to Wasabi.

Storage classes

Click the pencil button next to Storage classes on General. The Storage Classes dialog lets you keep the default choices, add your provider's codes, or replace the list entirely.

For mode examples and instructions on using the configured choices, see Custom Storage Classes. Click OK to return to General.

Connection

Open the Connection tab to configure SSL/TLS certificate validation and the Proxy for this account. Both use the global settings by default. You can require certificate validation or bypass it for this account, and choose a direct connection, automatic proxy detection, or a manual proxy independently of the global configuration. See account connection settings for the options and the Proxy Settings dialog.

Miscellaneous

Open the Miscellaneous tab to configure optional API operations and external buckets.

List All My Buckets When Account Assigned - When checked, CS Browser will perform the s3:ListAllMyBuckets call when the account is assigned. If the account does not have permission to list all buckets, you can uncheck this option to avoid failed tasks and warnings in the log.

List All My Buckets in All Regions - When checked, CS Browser will perform the s3:ListAllMyBuckets call for each region. This is useful for storage providers that support multiple regions but do not offer a unified endpoint for listing all buckets across regions. To use this feature correctly, you need to specify the regions and a region-specific endpoint in the Regions dialog.

Use the Multi-Object Delete API - if checked, CS Browser can delete up to 1,000 files in a single API request. This is possible when the storage supports the Multi-Object Delete API. Most Amazon S3 compatible storage services support this feature, so you may keep this option turned on in most cases.

Use Multi-Part Copy - if checked, CS Browser can copy large files using the Multi-Part Copy API. This is possible when the storage supports the Multi-Part Copy API. Most Amazon S3 compatible storage services support this feature, so you may keep this option turned on in most cases.

Use Custom Checksum Algorithms - enable this option if the storage supports custom checksums via the x-amz-checksum-<algo> header. Supported algorithms include CRC32, CRC32C, CRC-64/NVME, SHA-1, and SHA-256.

External Buckets - You can edit the external buckets associated with the account. Each bucket should be listed on a new line. Optional paths are also supported, with a slash used as the delimiter (e.g., my-bucket/and/optional/path).

When finished, click Close, then save the account in the parent dialog. When editing through Manage accounts, click Save changes in both Edit Account and Storage Accounts.

Working with Amazon S3 compatible Storage Accounts

Amazon S3 compatible Storages overview