Scaleway Object Storage

Object Storage Overview


Scaleway Object Storage is an Object Storage service based on the S3 protocol. It allows you to store any kind of objects (documents, images, videos, etc.).

Object Storage service is a cloud product which means that your objects are always available from anywhere in the world. For instance, a typical use case for Object Storage would be to store images in a public bucket to make them broadly available via the HTTP protocol.

You can manage your storage directly from the Scaleway Console. When on the control panel, you can easily upload, download and visualize the objects in your buckets. In addition, many existing libraries or CLI clients can be integrated into your application or scripts.

Core Concepts

Object Storage: Object storage, contrary to previous storage methods (block devices, file-systems…), essentially bundles the data itself along with metadata tags and a unique identifier (instead of a file name and a file path). Object storage organizes information into buckets of flexible sizes, referred to as objects.These unique identifiers are arranged in a flat address space which makes it easier to locate and retrieve your data across regions. This flat address space also helps with scalability.

Bucket: A bucket is a groups of objects sharing a common denominator. It can contain as many objects as the you want. However the bucket might slowdown with a large number of objects (>500 000).

S3: S3 is the de facto object storage protocol, it was created by Amazon for its own object storage service, and is the most used in the world. Object Storage officially supports a subset of S3.
The list of supported features are described in the Object Storage API documentation.

Signature V2, Signature V4: When you send HTTP requests to Object Storage, you sign the requests so that we can identify who sent them. You sign requests with your Scaleway access key, which consists of an access key and secret key. The two main s3 protocols for authentication are Signature v2 and Signature v4. Signature v4 is more recent and it is the recommended version.
Usually, the signature should not be an issue for you as it is computed by the client software or library, not manually.

Region and Endpoint: Scaleway Object Storage is currently available in three Availability Zones (AZ/Region). The Endpoint to use differs depending on the geographical location of the object storage platform:

  • Amsterdam, The Netherlands:
    • Region: nl-ams
    • Endpoint:
  • Paris, France:
    • Region: fr-par
    • Endpoint:
  • Warsaw, Poland:
    • Region: pl-waw
    • Endpoint:

Supported Open Source Clients

Object Storage Use Cases

Scaleway Object Storage can be used in multiple use cases. To inspire you with common use cases, we came up with different tutorials such as:

More tutorials will follow soon.

Operation Procedures

Most operations can be performed through the S3 protocol via a CLI tool like s3cmd or through Scaleway Console.

To access the S3 services, you need to be in possession of an Access key and Secret key. You can generate these credentials from your management console.

Creating a Bucket through the Scaleway Console

1 . Log in to the Scaleway Console

2 . Click Storage from the left side menu. The Storage page lists all your buckets. At first your list is empty as you have not created any bucket yet.

3 . Click Create a Bucket to create a bucket that will store your objects

4 . Name your bucket and validate your bucket creation. A bucket name must:

  • be unique
  • contain only alphanumeric and lowercase characters

Important: The SSL certificate does not support bucket names containing additional dots (.). You may receive a SSL warning in your browser when accessing a bucket like and it is recommended to use dashes (-) instead:

Creating a Bucket through the CLI

john@localhost:~$ s3cmd mb s3://mynewbucket

Bucket 's3://mynewbucket/' created

In addition, the full list of the S3 API operations supported, is available here.

Object Storage Limitation

To ensure we provide the best performances, we listed below the current limitations of the feature:

  • Each Scaleway Organization can use up to 250TB of Object Storage resources. If you wish to increase your Object Storage quota, contact the Support.
  • Currently a limit of 10,000 buckets per project is applied
  • Maximum number of objects in a bucket: no specific limit, however, the bucket might slowdown with a large number of objects
  • Maximum parts of an object: 1000 parts (parts can be of arbitrary size)

In case you need to raise those limitations, contact the Support team.

Troubleshooting and Error Message

The user can encounter the following error message:

_Token invalid: The client token or secret is invalid._

We suggest to check the user’s configuration. For users using v4 signature method, ensure given region is correct (e.g., “nl-ams” for the Amsterdam region).

Object Storage and S3 Compatibility

Refer to Scaleway FAQ for more information regarding S3 compatibility.

A full list of S3 API operations is available here.

Note: Scaleway Object Storage provides full read-after-write consistency to ensure that changes are immediately visible (reading data) right after making those changes (writing data).

Discover the Cloud That Makes Sense