Skip to main content
Use a dedicated private S3 disk for workspace originals and the derivatives that Studio writes to it. Files uploaded through Laravel can use this disk with the default transfer settings. Enable direct multipart separately when browsers should send large parts directly to the bucket.

Configure the Laravel disk

Add the Laravel S3 adapter to the host application if it is missing.
Add a disk under disks in config/filesystems.php. This example lets the SDK resolve credentials from the deployment environment or an AWS role.
Keep S3 Block Public Access enabled. Scope the application role to the bucket and Studio-owned prefixes it needs. If the app and queue workers use separate roles, give each role access to the objects its feature reads or writes. Use Laravel’s endpoint and use_path_style_endpoint settings for a compatible provider that requires them. Check signed requests, checksums, range reads and deletion against that provider before enabling the corresponding workflows. Laravel filesystem documentation

Select it for new workspaces

Merge this fragment into config/media-studio.php.
Existing workspaces retain their disk and root. Before migrating an existing workspace, verify its storage references and plan how to copy objects, validate both originals and derivatives, and roll back. Changing the default only affects workspaces created afterward.

Test storage and delivery separately

  1. Create a test workspace after applying the disk configuration. Upload a JPEG and verify that a signed-in viewer can open the preview and download the original.
  2. If processing is enabled, wait for the thumbnail and confirm that the worker can read the original and write its output.
  3. Open the unmodified object URL in a signed-out browser. Use Studio’s authorized media or share routes to check the intended public or private access independently.
  4. Test seeking in a supported video through the production ingress. Verify the range response and review CDN delivery before adding edge caching.
Use S3 encryption and KMS for encryption policies. To browse objects already stored by another application, use existing disk sources. For files written to R2 and delivered through an edge binding, see Cloudflare Worker and private R2.