Skip to main content

Quickstart - AWS CLI

If you have the AWS CLI installed, you can start using Fil One in under 2 minutes.

1. Install the AWS CLI

pip install awscli
# or
brew install awscli

2. Configure credentials

aws configure

Enter your Fil One access key and secret key when prompted. Set the region to eu-west-1.

3. Create a bucket

aws s3 mb s3://my-first-bucket --endpoint-url https://eu-west-1.s3.fil.one

4. Upload a file

aws s3 cp my-file.txt s3://my-first-bucket/ --endpoint-url https://eu-west-1.s3.fil.one

5. List objects

aws s3 ls s3://my-first-bucket/ --endpoint-url https://eu-west-1.s3.fil.one

6. Download the file

aws s3 cp s3://my-first-bucket/my-file.txt ./downloaded.txt --endpoint-url https://eu-west-1.s3.fil.one
tip

Tired of typing --endpoint-url every time? Set up a named profile so you never have to:

# ~/.aws/config
[profile filone]
endpoint_url = https://eu-west-1.s3.fil.one
region = eu-west-1
# ~/.aws/credentials
[filone]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY

Then use --profile filone instead of --endpoint-url on every command:

aws s3 ls --profile filone