Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Data (S3)

Enable S3 storage via MinIO S3

Onyxia exchanges the user's OIDC access token for temporary S3 credentials through AssumeRoleWithWebIdentity. This guide uses MinIO; other S3 systems compatible with this STS API are also supported.

We assume the previous authentication step 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, 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:

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

Deploy MinIO through ArgoCD:

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

For an S3 Explorer without the Onyxia API, use values-s3-explorer-only.yaml and the standalone deployment guide. 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.

Next, configure Vault for secrets and saved user settings:

Vault

Last updated

Was this helpful?