---
title: OVHcloud Object Storage
description: OVHcloud Object Storage via the S3-compatible API. Endpoint derived from the region code.
---

## 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.

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

`upload` also needs the optional `@aws-sdk/lib-storage` package when it uses `onProgress`, `multipart`, or a `ReadableStream` body of unknown length. It's only loaded then.

## Usage

```ts lineNumbers
import { Files } from "files-sdk";
import { ovhcloud } from "files-sdk/ovhcloud";

const files = new Files({
  adapter: ovhcloud({
    bucket: "uploads",
    region: "gra", // or "sbg", "de", "uk", "waw", "sgp", "ap-southeast-syd"
    // accessKeyId / secretAccessKey auto-loaded from
    // OVH_ACCESS_KEY_ID / OVH_SECRET_ACCESS_KEY
  }),
});
```

OVHcloud Object Storage via its S3-compatible API. A thin wrapper around the S3 adapter - endpoint derived from the region code (`gra`, `rbx`, `sbg`, `bhs`, `de`, `uk`, `waw`, `eu-west-par`, `sgp`, `ap-southeast-syd`, ...), virtual-hosted-style addressing, errors relabelled. The default host is `https://s3.<region>.io.cloud.ovh.net`, OVHcloud's main S3 endpoint, which serves every storage class (Standard by default). To use the legacy `https://s3.<region>.perf.cloud.ovh.net` endpoint or the Swift-backed `https://s3.<region>.cloud.ovh.net` (some regions only), pass it as `endpoint`. Auto-loads from `OVH_ACCESS_KEY_ID` and `OVH_SECRET_ACCESS_KEY`. Generate S3 credentials in the OVHcloud Control Panel under Public Cloud -> Object Storage -> S3 users.

## Options

<AutoTypeTable
  path="../../packages/files-sdk/src/ovhcloud/index.ts"
  name="OvhcloudAdapterOptions"
/>

## Compatibility

| Method | Status | Notes |
| --- | :-: | --- |
| `upload` | ✅ |  |
| `download` | ✅ |  |
| `delete` | ✅ |  |
| `list` | ⚠️ | The S3 list API returns no per-object `Content-Type`, so `contentType` is inferred from the key's extension (`application/octet-stream` when unknown). Use `head()` for the stored value. |
| `search` | ✅ |  |
| `head` | ✅ |  |
| `exists` | ✅ |  |
| `copy` | ✅ |  |
| `url` | ✅ |  |
| `signedUploadUrl` | ✅ |  |