Quickstart - SDK

Choose your language and follow along. Each example uploads a file and verifies it. Create the bucket first in the dashboard — CreateBucket over the S3 API is not available in eu-west-1, the default region these examples use.

The endpoint depends on your bucket's region

These examples use eu-west-1, the default region. For a bucket in us-east-1, use https://us-east-1.s3.filonecontent.com and region us-east-1. The endpoint, the region, and your access key must all refer to the same region.

Python

pip install boto3

import boto3
from botocore.config import Config

s3 = boto3.client(
    "s3",
    endpoint_url="https://eu-west-1.s3.filonecontent.com",
    aws_access_key_id="YOUR_ACCESS_KEY",
    aws_secret_access_key="YOUR_SECRET_KEY",
    region_name="eu-west-1",
    config=Config(s3={"addressing_style": "path"}),
)

# Upload a file (create the bucket first in the dashboard)
s3.upload_file("my-file.txt", "my-sdk-bucket", "my-file.txt")

# Verify
response = s3.list_objects_v2(Bucket="my-sdk-bucket")
for obj in response.get("Contents", []):
    print(f"{obj['Key']}  ({obj['Size']} bytes)")

JavaScript

npm install @aws-sdk/client-s3

import { S3Client, PutObjectCommand, ListObjectsV2Command } from "@aws-sdk/client-s3";
import { readFileSync } from "fs";

const client = new S3Client({
  endpoint: "https://eu-west-1.s3.filonecontent.com",
  region: "eu-west-1",
  forcePathStyle: true,
  credentials: {
    accessKeyId: "YOUR_ACCESS_KEY",
    secretAccessKey: "YOUR_SECRET_KEY",
  },
});

// Upload a file (create the bucket first in the dashboard)
await client.send(new PutObjectCommand({
  Bucket: "my-sdk-bucket",
  Key: "my-file.txt",
  Body: readFileSync("my-file.txt"),
}));

// Verify
const { Contents } = await client.send(
  new ListObjectsV2Command({ Bucket: "my-sdk-bucket" })
);
Contents?.forEach((obj) => console.log(obj.Key, obj.Size));

Go

go get github.com/aws/aws-sdk-go-v2/service/s3
go get github.com/aws/aws-sdk-go-v2/credentials

package main

import (
    "context"
    "fmt"
    "os"
    "strings"

    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/credentials"
    "github.com/aws/aws-sdk-go-v2/service/s3"
)

func main() {
    client := s3.New(s3.Options{
        BaseEndpoint:  aws.String("https://eu-west-1.s3.filonecontent.com"),
        Region:        "eu-west-1",
        UsePathStyle:  true,
        Credentials: credentials.NewStaticCredentialsProvider(
            os.Getenv("FIL_ACCESS_KEY"),
            os.Getenv("FIL_SECRET_KEY"),
            "",
        ),
    })

    ctx := context.Background()

    // Upload (create the bucket first in the dashboard)
    client.PutObject(ctx, &s3.PutObjectInput{
        Bucket: aws.String("my-sdk-bucket"),
        Key:    aws.String("hello.txt"),
        Body:   strings.NewReader("Hello from Go!"),
    })

    // List
    out, _ := client.ListObjectsV2(ctx, &s3.ListObjectsV2Input{
        Bucket: aws.String("my-sdk-bucket"),
    })
    for _, obj := range out.Contents {
        fmt.Printf("%s (%d bytes)\n", *obj.Key, *obj.Size)
    }
}

For more detailed examples including multipart uploads and presigned URLs, see the dedicated SDK pages:

PythonJavaScriptGo