> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gcore.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect AWS CLI, S3cmd, and AWS JavaScript SDK

> Connect AWS command line tools, S3cmd, and AWS JavaScript SDK to Gcore Object Storage using access keys and an endpoint.

AWS CLI, S3cmd, and the AWS JavaScript SDK all use the same credentials to connect to Gcore Object Storage: an access key and secret key from [access keys](/storage/manage-object-storage/manage-s3-access-keys), and an [endpoint URL](/storage/manage-object-storage/s3-service-urls-and-default-region-names). The setup format differs by tool — select a tab for the specific steps.

**AWS CLI**

AWS CLI integrates with Gcore Object Storage for bucket management using commands from the [Amazon documentation](https://docs.aws.amazon.com/cli/latest/reference).

### Installation

**1. Install AWS CLI**

Follow the [installation guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) to install the latest version.

**2. Verify installation**

Run the following command to confirm the installation succeeded:

```sh theme={null}
aws --version
```

The output shows the installed version and operating system:

```sh theme={null}
aws-cli/2.7.24 Python/3.8.8 Windows/10 exe/AMD64 prompt/off
```

If the terminal cannot find the `aws` command, consult the [troubleshooting guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-troubleshooting.html).

### Configuration

**1. Launch the configuration wizard**

Run `aws configure`.

**2. Enter storage credentials**

Provide the following values:

* **Access Key**: the storage access key.
* **Secret Key**: the storage secret key.
* **Default region name**: the [region name](/storage/manage-object-storage/s3-service-urls-and-default-region-names) for the storage location — `s-ed1` for Luxembourg-2.
* Leave all other parameters at their default values.

**3. Verify the connection**

Run the following command, replacing the endpoint with the actual value from the [service URLs](/storage/manage-object-storage/s3-service-urls-and-default-region-names) reference:

```sh theme={null}
aws s3 ls --endpoint-url=https://s-ed1.cloud.gcore.lu
```

Correct credentials produce no errors and list any existing buckets. An empty output with exit code 0 is expected for new storage with no buckets.

**S3cmd**

S3cmd is a free command-line tool for uploading, retrieving, and managing objects in S3-compatible storage. The full command reference is in the [S3cmd documentation](https://s3tools.org/usage).

### Installation

**1. Download S3cmd**

Go to the [Download](https://s3tools.org/download) page in the S3cmd documentation.

**2. Install the package**

Download and install the package for the operating system.

### Configuration

Two methods are available: the interactive wizard and direct command-line input for automated environments.

> **With wizard**
>
> **1. Launch the wizard**
>
> Run the following command:
>
> ```sh theme={null}
> s3cmd --configure
> ```
>
> **2. Enter storage credentials**
>
> Provide the following values:
>
> * **Access Key**: the storage access key.
> * **Secret Key**: the storage secret key.
> * **S3 Endpoint**: the [storage endpoint](/storage/manage-object-storage/s3-service-urls-and-default-region-names) — `s-ed1.cloud.gcore.lu` for Luxembourg-2.
> * **DNS-style bucket+hostname**: the same endpoint — `s-ed1.cloud.gcore.lu`. Optionally append the port: `s-ed1.cloud.gcore.lu:80`.
> * Leave all other parameters at their default values.
>
> S3cmd verifies the credentials and reports a success message:
>
> ```sh theme={null}
> Success. Your access key and secret key worked fine :-)
> ```
>
> The configuration is saved to `~/.s3cfg`:
>
> ```toml theme={null}
> [default]
> access_key = 123ABC456DEF...
> secret_key = EXAMPLE...
> host_base = s-ed1.cloud.gcore.lu
> host_bucket = s-ed1.cloud.gcore.lu
> ```

> **Without wizard**
>
> For scripted or automated environments that cannot accept interactive input, write the configuration directly to `~/.s3cfg`:
>
> ```sh theme={null}
> s3cmd --access_key 12*****6DEF --secret_key EX***** --host s-ed1.cloud.gcore.lu --host-bucket s-ed1.cloud.gcore.lu
> ```
>
> Where:
>
> * `12*****6DEF` is the storage access key.
> * `EX*****` is the storage secret key.
> * `s-ed1.cloud.gcore.lu` is the [storage endpoint](/storage/manage-object-storage/s3-service-urls-and-default-region-names).

**AWS JavaScript SDK**

> [!NOTE]
>
> The code examples use AWS SDK for JavaScript v2 (`aws-sdk`), which is in maintenance mode but remains functional. The [migration guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/migrating-to-v3.html) covers the path to SDK v3 (`@aws-sdk/client-s3`), which AWS recommends for new projects.

### SDK setup

Add the AWS SDK script to the HTML page:

```html theme={null}
<html>
    <head>
        <script src="https://sdk.amazonaws.com/js/aws-sdk-2.742.0.min.js"></script>
        <script src="./js/index2.js"></script>
    </head>
    <body>
        <h1>List of files</h1>
        <ul id="list">
        </ul>
    </body>
</html>
```

### Storage operations

#### Credentials and bucket name

Open the configuration file (`./js/index2.js`) and specify the storage credentials and bucket name:

```js theme={null}
var s3BucketName = "test";
var host = "https://s-ed1.cloud.gcore.lu";
var access_key = "1234";
var secret_key = "5678";

AWS.config.accessKeyId = access_key;
AWS.config.secretAccessKey = secret_key;
AWS.config.endpoint = host;

var s3 = new AWS.S3({
    sslEnabled: true
});
```

Where:

* `test` is the bucket name.
* `https://s-ed1.cloud.gcore.lu` is the [storage endpoint](/storage/manage-object-storage/s3-service-urls-and-default-region-names).
* `1234` is the storage access key.
* `5678` is the storage secret key.

#### CORS policy

A wildcard CORS policy allows cross-origin GET, HEAD, PUT, POST, and DELETE requests from all sources:

> [!NOTE]
>
> This configuration is permissive and may be insecure for production environments.

```xml theme={null}
<CORSConfiguration>
<CORSRule>
    <ID>Allow everything</ID>
    <AllowedOrigin>*</AllowedOrigin>
    <AllowedMethod>GET</AllowedMethod>
    <AllowedMethod>HEAD</AllowedMethod>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedMethod>POST</AllowedMethod>
    <AllowedMethod>DELETE</AllowedMethod>
    <AllowedHeader>*</AllowedHeader>
    <MaxAgeSeconds>30</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
```

Apply the policy to the bucket:

```sh theme={null}
s3cmd setcors cors.xml s3://<bucket_name>
```

#### Add objects to a bucket

The following example adds two objects (`test_file1` and `test_file2`) to the `s3test` bucket:

```js theme={null}
var params1 = {
   Bucket: "s3test", Key: "test_file1",
   Body: "test"
};
var params2 = {
   Bucket: "s3test", Key: "test_file2",
   Body: "test"
};
var request = s3.putObject(params1);
request.send(function (err, data) {
   if (err) console.log("Error:", err.code, err.message);
   else console.log(data);
});
var request = s3.putObject(params2);
request.send(function (err, data) {
   if (err) console.log("Error:", err.code, err.message);
   else console.log(data);
});
```

#### List objects in a bucket

The following example retrieves all objects in the `test_2` bucket:

```js theme={null}
params = {
    Bucket: "test_2"
};
s3.listObjects(params, function(err, data) {
    if (err) return;
    data.Contents.map(function(info) {
        var ul = document.getElementById("list");
        var li = document.createElement("li");
        li.innerText = info.Key + " " + info.LastModified;
        ul.append(li);
    });
});
```