From becd649130686577aeac67947f0d1e0b6716c507 Mon Sep 17 00:00:00 2001 From: Will Jones Date: Tue, 7 May 2024 10:15:26 -0700 Subject: [PATCH] docs: add tip about using allow_http on local servers (#1277) Based on user question https://discord.com/channels/1030247538198061086/1197630499926057021/1237350091191222293 --- docs/src/guides/storage.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/src/guides/storage.md b/docs/src/guides/storage.md index bd014b35e..078ff1b60 100644 --- a/docs/src/guides/storage.md +++ b/docs/src/guides/storage.md @@ -299,6 +299,14 @@ LanceDB can also connect to S3-compatible stores, such as MinIO. To do so, you m This can also be done with the ``AWS_ENDPOINT`` and ``AWS_DEFAULT_REGION`` environment variables. +!!! tip "Local servers" + + For local development, the server often has a `http` endpoint rather than a + secure `https` endpoint. In this case, you must also set the `ALLOW_HTTP` + environment variable to `true` to allow non-TLS connections, or pass the + storage option `allow_http` as `true`. If you do not do this, you will get + an error like `URL scheme is not allowed`. + #### S3 Express LanceDB supports [S3 Express One Zone](https://aws.amazon.com/s3/storage-classes/express-one-zone/) endpoints, but requires additional configuration. Also, S3 Express endpoints only support connecting from an EC2 instance within the same region.