Yandex Object Storage

Yandex Object Storage via the S3-compatible API. Fixed global endpoint, region defaults to ru-central1, keys auto-loaded from YANDEX_* env vars.

Installation

@aws-sdk/client-s3, @aws-sdk/s3-presigned-post, and @aws-sdk/s3-request-presigner are optional peer dependencies of files-sdk - install alongside the SDK so the adapter’s imports resolve at runtime.

npm install files-sdk @aws-sdk/client-s3 @aws-sdk/s3-presigned-post @aws-sdk/s3-request-presigner

pnpm add files-sdk @aws-sdk/client-s3 @aws-sdk/s3-presigned-post @aws-sdk/s3-request-presigner

yarn add files-sdk @aws-sdk/client-s3 @aws-sdk/s3-presigned-post @aws-sdk/s3-request-presigner

bun add files-sdk @aws-sdk/client-s3 @aws-sdk/s3-presigned-post @aws-sdk/s3-request-presigner

Usage

import { Files } from "files-sdk";
import { yandex } from "files-sdk/yandex";

const files = new Files({
  adapter: yandex({
    bucket: "uploads",
    // endpoint defaults to https://storage.yandexcloud.net
    // region defaults to "ru-central1"
    // accessKeyId / secretAccessKey auto-loaded from
    // YANDEX_ACCESS_KEY_ID / YANDEX_SECRET_ACCESS_KEY
  }),
});

Yandex Object Storage via its S3-compatible API. A thin wrapper around the S3 adapter - fixed global endpoint, region defaults to "ru-central1" for signing, virtual-hosted-style addressing, errors relabelled. Auto-loads from YANDEX_ACCESS_KEY_ID and YANDEX_SECRET_ACCESS_KEY. Generate static access keys in the Yandex Cloud console for a service account with the storage.editor role.

Options

Compatibility