Skip to content

Commit

Permalink
docs: move minio media upload troubleshooting to s3 guide
Browse files Browse the repository at this point in the history
  • Loading branch information
marcklingen committed Dec 20, 2024
1 parent 4c65c13 commit dbd3ad9
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 7 deletions.
8 changes: 1 addition & 7 deletions pages/self-hosting/docker-compose.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -127,13 +127,7 @@ Ensure to stop the VM instance in your cloud provider interface to avoid unneces

## Troubleshooting

### Configuring Minio for Media Uploads

To enable multimodal tracing, presigned URLs allow SDK clients and browsers outside the Docker network to directly upload and download media assets. Therefore, the `LANGFUSE_S3_MEDIA_UPLOAD_ENDPOINT` must resolve to the Docker host's address.

**Development Environment:** When running `docker compose` locally, set `LANGFUSE_S3_MEDIA_UPLOAD_ENDPOINT` to `http://localhost:9090` to ensure presigned URLs correctly loop back to the local instance.

**Production Environment:** In a production environment, configure `LANGFUSE_S3_MEDIA_UPLOAD_ENDPOINT` with a publicly accessible hostname or IP address that is reachable by your SDK clients and browsers.
- Multimodal tracing is not working: This docker compose setup by default uses MinIO for blob storage which is not accessible from outside the Docker network for direct uploads. Please refer to the [blob storage guide](/self-hosting/infrastructure/blobstorage#minio-media-uploads) for more details on how to configure MinIO for media uploads.

## How to Upgrade

Expand Down
8 changes: 8 additions & 0 deletions pages/self-hosting/infrastructure/blobstorage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,14 @@ LANGFUSE_S3_EVENT_UPLOAD_PREFIX=events/
This example setup uses an ephemeral volume, i.e. on restarts MinIO will discard all event data.
Please follow the MinIO documentation or use a cloud provider managed blob store for persistent data storage.

#### Configuring Minio for Media Uploads [#minio-media-uploads]

To enable multimodal tracing, presigned URLs allow SDK clients and browsers outside the Docker network to directly upload and download media assets. Therefore, the `LANGFUSE_S3_MEDIA_UPLOAD_ENDPOINT` must resolve to the Docker host's address.

**Development Environment:** When running `docker compose` locally, set `LANGFUSE_S3_MEDIA_UPLOAD_ENDPOINT` to `http://localhost:9090` to ensure presigned URLs correctly loop back to the local instance.

**Production Environment:** In a production environment, configure `LANGFUSE_S3_MEDIA_UPLOAD_ENDPOINT` with a publicly accessible hostname or IP address that is reachable by your SDK clients and browsers.

### Cloudflare R2

[Cloudflare R2](https://www.cloudflare.com/developer-platform/products/r2/) is globally available, S3 compatible object storage by Cloudflare.
Expand Down

0 comments on commit dbd3ad9

Please sign in to comment.