> For the complete documentation index, see [llms.txt](https://docs.stackmate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackmate.io/configuration/object-storage.md).

# Object storage

Stackmate offers infrastructure deployment for object storage services (like AWS S3 for example)

### What you get when introducing this service to your configuration

* As many object storage buckets you've specified in your configuration with versioning, encryption or public access configured

### Required attributes

* `type` - **string** - It should be set to `objectstore`
* `buckets` - **array** - a list of objects with the following attributes:
  * `name` - **string, required** - the bucket's name
  * `versioning` - **boolean, optional** - whether to enable versioning for objects, `false` by default
  * `encrypted` - **boolean, optional** - whether objects are encrypted in the bucket, `false` by default
  * `publicRead` - **boolean, optional** - whether the objects are publicly available for reading, `false` by default

The typical [Common Service Options](/configuration/configuration-file/environments.md#common-service-options) apply here too.

### Accessing the bucket

{% hint style="info" %}
Please read the following if you plan to grant programmatic access to your buckets
{% endhint %}

Stackmate creates a user in your cloud that is able to access and manage objects in the newly created bucket and a policy is assigned to it. The user does not have any credentials assigned to it, so you should log in through your console and create them yourself.

### Example configuration

```yaml
# ... the rest of the configuration ...
environments:
  production:
    # ... more services ...
    my-storage:
      type: objectstore
      buckets:
        - name: my-super-bucket
          versioning: true
        - name: my-other-awesome-bucket
          encrypted: true
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stackmate.io/configuration/object-storage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.