diff --git a/docs/using/minio.md b/docs/using/minio.md new file mode 100644 index 00000000000..b5527d6e47a --- /dev/null +++ b/docs/using/minio.md @@ -0,0 +1,32 @@ +--- +layout: default +title: MinIO +description: This section covers how to use MinIO as the underlying storage for lakeFS. +parent: Using lakeFS with... +nav_order: 47 +has_children: false +--- + +# Using lakeFS with MinIO + +[MinIO](https://min.io) is a high performance, distributed object storage system. You can use lakeFS to add git-like capabilities over it. +For learning purposes, it is recommended to follow our [step-by-step guide](https://lakefs.io/git-like-operations-over-minio-with-lakefs/) on how to deploy lakeFS locally over MinIO. + +If you already know how to install lakeFS, and want to configure it to use MinIO as the underlying storage, your lakeFS configuration should contain the following: + +```yaml +blockstore: + type: s3 + s3: + force_path_style: true + endpoint: http://:9000 + credentials: + access_key_id: + secret_access_key: +``` + +The full example can be found [here](https://docs.lakefs.io/reference/configuration.html#example-minio). + +Note that lakeFS can also be configured [using environment variables](https://docs.lakefs.io/reference/configuration.html#using-environment-variables). + +