S3: Support `bucket_endpoint` configuration
Author: cweiskeCreated Sep 17, 2026Updated Sep 17, 2026
Feature Request
| Q | A |
|---|---|
| Flysystem Version | 3.36.0 |
| Adapter Name | league/flysystem-aws-s3-v3 |
| Adapter version | 3.35.3 |
Scenario / Use-case
My servers get the S3 endpoint + bucket in a single environment variable STORAGE_PATH_URI, e.g. https://storage.example.org/my-bucket.
AWS S3Client supports a bucket_endpoint configuration option that tells the client to pull the bucket from the endpoint configuration.
Simply adding 'bucket_endpoint' => true does not work without adding a dummy bucket - you'd get the following exception:
League\Flysystem\AwsS3V3\AwsS3V3Adapter::__construct(): Argument #2 ($bucket) must be of type string, null given, called in vendor/laravel/framework/src/Illuminate/Filesystem/FilesystemManager.php on line 263
Summary
It would be nice if a null bucket config option would be allowed when bucket_endpoint is enabled.
Source: thephpleague/flysystem