# User Demo 1

In this user demo, we guide you through setting up and utilizing AWS Command Line Interface (CLI) with Flostream Storage, enabling you to seamlessly interact with our ecosystem using familiar tools. 

**Step 1:** To get started, make sure Python is installed on your system.

**Step 2:** Once Python is set up, install the AWS CLI (<https://aws.amazon.com/cli/>).&#x20;

**Step 3:** Configure AWS CLI to communicate with Flostream Storage by following these steps:&#x20;

* Create a configuration file named: *\~/.awsrc*&#x20;
* Input your specific AWS API key and endpoint information, enabling secure and direct communication with Flostream's storage clusters

**Step 4:** Source the configuration file in order to perform operation including listing buckets and managing objects to seamlessly transferring data between your local system and Flostream storage. We've included basic commands like listing, copying, and managing in order to showcase the versatility and power of this integration.&#x20;

**What's next?** Once configured, the journey has just started to unlock Flostream's full potential. It's that easy. Now you're ready for the advanced functionalities beyond basic operations. Whether you're creating buckets, pre-signing requests, or managing websites, our documentation has resources on feature limitations, compatibility status, ACL or policy functionalities, and more.

**Additional Resources for AWSCLI + Flostream demo:**

Install AWSCLI if you have Python installed:

```bash
python -m pip install --user awscli
```

More on AWS CLI: <https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html>

Now that `awscli` is installed, you must configure it to communicate with Flostream Storage. There are multiple ways to do that, the simplest one is to create a file named `~/.awsrc` with this content:

```bash
export AWS_ACCESS_KEY_ID=xxxx      # put your Key ID here
export AWS_SECRET_ACCESS_KEY=xxxx  # put your Secret key here
export AWS_DEFAULT_REGION='eu-1'
export AWS_ENDPOINT='https://s3.eu-1-ez.flo.stream'

function aws { command aws --endpoint-url $AWS_ENDPOINT $@ ; }
aws --version
```

The API keys will be specific to your account. The AWS\_ENDPOINT will be provided along with the API keys. The endpoint will point to a cell cluster inside of the Flostream Storage ecosystem.

Now, each time you want to use `awscli` on this target, run:<br>

```bash
source ~/.awsrc
```

Example usage of `awscli`

```bash
# list buckets
aws s3 ls

# list objects of a bucket
aws s3 ls s3://my_data

# copy from your filesystem to Flostream Storage
aws s3 cp ./cat.jpg s3://my_data/cat.jpg

# copy from Flostream Storage account to your filesystem
aws s3 cp s3://my_data/cat.jpg ./cat.jpg
```

*Note:* You can use `awscli` for more advanced operations like creating a bucket, pre-signing a request or managing your website. [Read the full documentation ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/index.html)to learn more. Some features are however not implemented like ACL or policy, so check S3 Compatibility status first.

Enjoy this hassle-free experience!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flo.stream/welcome-to-flostream/getting-started/user-demo-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.