Storage provider

s3nd with Scaleway Object Storage

European regions, S3-compatible, and the region actually means something.

createBucket()

import { createBucket } from 's3nd'

const store = createBucket({
  bucket: 'transfers',
  region: 'fr-par',
  endpoint: 'https://s3.fr-par.scw.cloud',
  credentials: {
    accessKeyId: process.env.SCW_ACCESS_KEY!,
    secretAccessKey: process.env.SCW_SECRET_KEY!,
  },
})

Why this one

Scaleway Object Storage

Scaleway's Object Storage is S3-compatible with one difference worth knowing: it uses the region. Pass fr-par, nl-ams or pl-waw explicitly rather than letting the endpoint default it to "auto".

From the command line

A starter configuration, and what is left to do.

init writes the file with ${VAR} references rather than secrets, so it is meant to be committed; the env file it points at is not.

$s3nd init --provider scaleway --bucket transfers

s3nd.config.json

{
  "bucket": "transfers",
  "region": "fr-par",
  "endpoint": "https://s3.fr-par.scw.cloud",
  "prefix": "transfers",
  "expiresIn": "24h",
  "envFile": ".env",
  "credentials": {
    "accessKeyId": "${SCW_ACCESS_KEY}",
    "secretAccessKey": "${SCW_SECRET_KEY}"
  }
}

Then

01Put SCW_ACCESS_KEY and SCW_SECRET_KEY in .env.
02Add a lifecycle rule on the transfers/ prefix.
03Run s3nd doctor. It performs the operations s3nd needs and reports what happened.

Worth knowing

Notes on Scaleway.

The region is real

The endpoint carries the region and the signature has to agree with it. Write both, in the same region.

Expiry cleanup

expiresIn stops a transfer being handed over; only a lifecycle rule deletes the object. Give the prefix a rule that expires objects after a day or two, and s3nd doctor turns green.

The full guide

Other providers

The endpoint is the only difference.

Cloudflare R2

No egress fees, which is exactly what moving a 2 GB file between two laptops wants.

AWS S3

The original. Credentials come from the provider chain, so a Lambda or an ECS task needs no keys at all.

MinIO

One Docker command, and the real code path runs on your laptop and in CI.

Wasabi

Flat-rate storage with no egress charge, on a regional endpoint.

Put a file. Hand over the code.

Point it at the bucket you already pay for. Nothing to deploy, nothing to sign up for, nothing in the middle.

Install the CLI Put it in your app GitHub

$npm install -g @s3nd/cli$s3nd init --provider r2 --bucket drop$s3nd put ./anything.zip