S3 Compatibility
Fil One provides an S3-compatible API. If your application works with AWS S3, it works with Fil One — point your SDK or CLI at our endpoint and authenticate with your API keys.
Endpoint
https://eu-west-1.s3.fil.one
All requests use HTTPS. HTTP connections are rejected.
Authentication
Fil One supports AWS Signature Version 4 (SigV4) authentication. Any S3 client or SDK that supports SigV4 will work without modification.
| Parameter | Value |
|---|---|
| Endpoint | https://eu-west-1.s3.fil.one |
| Region | eu-west-1 |
| Signature version | SigV4 |
| Path style | Required |
| Virtual-hosted style | Not supported |
Supported operations
Bucket operations
| Operation | Status | Notes |
|---|---|---|
CreateBucket | ❌ Not supported | Buckets must be created via the dashboard. |
DeleteBucket | ❌ Not supported | Bucket deletion is not yet available. |
ListBuckets | ✅ Supported | |
HeadBucket | ✅ Supported |
Object operations
| Operation | Status | Notes |
|---|---|---|
PutObject | ✅ Supported | Max object size: 5 TB (use multipart for objects > 5 GB). |
GetObject | ✅ Supported | |
DeleteObject | ✅ Supported | |
HeadObject | ✅ Supported | |
ListObjectsV2 | ✅ Supported | |
CopyObject | ✅ Supported |
Multipart upload
| Operation | Status | Notes |
|---|---|---|
CreateMultipartUpload | ✅ Supported | |
UploadPart | ✅ Supported | |
CompleteMultipartUpload | ✅ Supported | |
AbortMultipartUpload | ✅ Supported |
Presigned URLs
| Operation | Status | Notes |
|---|---|---|
Presigned GetObject | ✅ Supported | |
Presigned PutObject | ✅ Supported |
Not yet supported
The following operations are planned for future releases:
| Operation | Timeline | Notes |
|---|---|---|
| Bucket policies / ACLs | Phase 2 | |
| Lifecycle rules | Phase 2 | |
| S3 Select | Not planned | |
| S3 Inventory | Not planned | |
| S3 Batch Operations | Not planned |
Error responses
Fil One returns standard S3 error XML for all error conditions. If you're handling S3 errors in your application today, no changes are needed.
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>NoSuchBucket</Code>
<Message>The specified bucket does not exist.</Message>
<BucketName>my-bucket</BucketName>
<RequestId>abc123</RequestId>
</Error>
See the Error Reference for a full list of error codes.
Differences from AWS S3
Fil One is S3-compatible, not an S3 clone. A few behaviors differ:
| Behavior | AWS S3 | Fil One |
|---|---|---|
| Bucket management | CreateBucket and DeleteBucket supported via API. | Not supported via API. Buckets are managed through the dashboard only. Deletion is not yet available. |
| IAM policies | Full IAM support. | Single-user accounts in the current release. IAM planned for a future release. |
| Public access | Configurable public bucket policies and ACLs. | No public bucket ACLs or public access settings. All access requires authentication. |
| Lifecycle rules | Supported (expiration, transitions, etc.). | Not supported in the current release. Planned for a future release. Affects common archival and cleanup workflows. |
| Storage classes | Multiple (Standard, IA, Glacier, etc.) | Single storage class. |
| Regions | 30+ regions globally. | eu-west-1 (additional regions planned). |