> For the complete documentation index, see [llms.txt](https://docs.onyxia.sh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onyxia.sh/admin-doc/readme/data-s3.md).

# Data (S3)

Enable S3 storage via MinIO S3

Onyxia exchanges the user's OIDC access token for temporary S3 credentials through [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html). This guide uses MinIO; other S3 systems compatible with this STS API are also supported.

We assume the [previous authentication step](https://docs.onyxia.sh/admin-doc/readme/user-authentication.md) configured the `minio` client and the `onyxia` token's `minio` audience, `onyxia-username`, and `minio-policy: stsonly` claims. **Onyxia reuses the token from its central `onyxia` client for MinIO STS.**

## Deploying MinIO

In Keycloak, obtain or regenerate the secret for the existing confidential `minio` client. Set it as `$KEYCLOAK_MINIO_CLIENT_SECRET` in [apps/minio/values.yaml](https://github.com/garronej/onyxia-ops/blob/main/apps/minio/values.yaml), and replace `$DOMAIN` with your domain. This secret is used by the MinIO Console; the Onyxia SPA has no client secret.

From your GitOps checkout, commit and push the configuration:

```bash
git add apps/minio/values.yaml
git commit -m "Configure MinIO authentication"
git push
```

Deploy MinIO through ArgoCD:

{% embed url="<https://app.tango.us/app/embed/75b62573-7adc-4a38-b1f9-b96bb0ea50fd>" %}

The supplied `stsonly` policy grants access to `user-<onyxia-username>` and its objects. The `minio-policy` claim selects this policy. For direct MinIO Console login, include `onyxia-username` on the `minio` client as described in the authentication step.

## Updating the Onyxia configuration

Merge the S3 region settings from [values-minio-enabled.yaml](https://github.com/garronej/onyxia-ops/blob/main/apps/onyxia/values-minio-enabled.yaml) into [apps/onyxia/values.yaml](https://github.com/garronej/onyxia-ops/blob/main/apps/onyxia/values.yaml), preserving your existing authentication and region settings. Replace `$DOMAIN` with your domain.

The personal bookmark must resolve to `s3://user-$1/` using the `onyxia-username` claim, matching MinIO's policy. Leave `data.S3.sts.oidcConfiguration` unset so Onyxia reuses its main access token.

```bash
git add apps/onyxia/values.yaml
git commit -m "Enable MinIO"
git push
```

For an S3 Explorer without the Onyxia API, use [values-s3-explorer-only.yaml](https://github.com/garronej/onyxia-ops/blob/main/apps/onyxia/values-s3-explorer-only.yaml) and the [standalone deployment guide](https://docs.onyxia.sh/admin-doc/readme/s3-explorer-standalone-deployment.md). It also uses the public `onyxia` client.

Sign in and check that you can create or access your personal bucket. Shared group buckets require additional storage policies; see [Setting up group projects](https://docs.onyxia.sh/admin-doc/setting-up-group-projects.md).

Next, configure Vault for secrets and saved user settings:

{% content-ref url="/pages/ICyiajR6Gdnxc42LvZsl" %}
[Vault](https://docs.onyxia.sh/admin-doc/readme/vault.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.onyxia.sh/admin-doc/readme/data-s3.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
