SDKs & Tools

Fil One works with any tool or library that supports the S3 API. You do not need a custom SDK -- configure your existing S3 tools to point at your region's endpoint and authenticate with your API keys.

Recommended tools

Tool	Language / Platform	Install
AWS CLI (v2)	Command line	brew install awscli (v2 required — v1 ignores endpoint_url in config)
boto3	Python	pip install boto3
AWS SDK v3	JavaScript / TypeScript	npm install @aws-sdk/client-s3
aws-sdk-go-v2	Go	go get github.com/aws/aws-sdk-go-v2/service/s3
rclone	Command line (multi-platform)	rclone.org/install
Cyberduck	macOS / Windows GUI	cyberduck.io

Connection details

Every SDK and tool needs the same four things:

Parameter	Value
Endpoint	https://<region>.s3.filonecontent.com
Region	eu-west-1 or us-east-1
Credentials	Your Access Key ID and Secret Access Key from the dashboard
Path-style addressing	Required. Fil One does not support virtual-hosted-style URLs — enable path-style in every client (forcePathStyle, addressing_style = path, UsePathStyle, etc.)

The endpoint is region-specific, and it has to match the region of the bucket you are addressing:

Region	Endpoint
Europe (France) eu-west-1 (default)	https://eu-west-1.s3.filonecontent.com
US East (Michigan) us-east-1	https://us-east-1.s3.filonecontent.com

Access keys are also scoped to a single region, so a key issued for eu-west-1 will not work against us-east-1. Code examples throughout these docs use eu-west-1 because it is the default — substitute your own region where it differs.

Quick setup guides

Python (boto3)Full examples for upload, download, and multipart.JavaScriptAWS SDK v3 examples for Node.js and browser.Goaws-sdk-go-v2 examples for server-side applications.AWS CLICommand-line reference for common operations.

Third-party tools

Most S3-compatible tools work with Fil One, subject to the same constraints as any S3 client — path-style addressing is required, and the gaps in the S3 Compatibility Reference apply. These have specific setup notes:

• rclone -- Sync files between local storage and Fil One. Configure with rclone config using the S3 provider type.
• Cyberduck -- GUI file browser for macOS and Windows. Add a new S3 connection with the Fil One endpoint.
• s3cmd -- Command-line tool. Configure with s3cmd --configure, then set both host_base = eu-west-1.s3.filonecontent.com and host_bucket = eu-west-1.s3.filonecontent.com/%(bucket)s in ~/.s3cfg. The host_bucket line is what forces path-style addressing; without it s3cmd stays in virtual-hosted mode and requests fail.
• MinIO Client (mc) -- mc alias set filone https://eu-west-1.s3.filonecontent.com YOUR_KEY YOUR_SECRET. Passing the secret on the command line leaves it in your shell history and the process list — prefer mc alias set filone https://eu-west-1.s3.filonecontent.com and let mc prompt for the key and secret interactively.

If you use a tool not listed here and run into compatibility issues, contact support.