Skip to main content

Storage Settings

Menu path: Admin -> Settings -> Storage Settings

Route: /admin/settings/storage

Use this page to choose where uploaded files are stored.

Storage modes​

  • Local Storage: store files on the same server
  • AWS / MinIO / RustFS: store files on S3-compatible storage

Field guide​

FieldWhat it meansWhat to enter
File DiskMain storage typeUse Local Storage for simple setups or s3 for external object storage
Access Key IDS3 access keyEnter the key from AWS, MinIO, RustFS, or your compatible service
Secret Access KeyS3 secret keyEnter the matching private key
RegionStorage regionExample: us-east-1
BucketContainer name for uploaded filesUse the exact bucket name
Path Style EndpointURL style for the bucketEnable this if your provider requires endpoint/bucket format
EndpointCustom storage server URLUse this for MinIO, RustFS, or custom S3-compatible services

Important note​

This page updates environment storage values from the admin panel.

When to use local storage​

Use local storage if:

  • you are running one server
  • file uploads stay on the same machine
  • you want the simplest setup

If you use local storage, also make sure php artisan storage:link is done after installation.

When to use S3-compatible storage​

Use S3-compatible storage if:

  • you want external file storage
  • you use more than one application server
  • you want easier file scaling or CDN support

For live production, this is the recommended storage type.

Recommended providers:

  • AWS S3 for a managed commercial option
  • MinIO for a free self-hosted option
  • RustFS for an S3-compatible alternative

If you use MinIO or RustFS, the simplest production setup is a public bucket for RoboExchanger uploads.

Common mistakes​

  • choosing s3 without filling the bucket details
  • using the wrong endpoint for MinIO or RustFS
  • using the wrong path-style setting
  • using a private MinIO or RustFS bucket while expecting direct public file URLs
  • forgetting to test real uploads after saving

Best practice​

  • Use public for simple single-server setups.
  • Use s3 for the best production setup.
  • Use AWS S3, MinIO, or RustFS for scalable object storage.
  • If you use MinIO or RustFS, make the bucket public and confirm the endpoint and path-style settings are correct.
  • For the best full production stack, also read Performance & Optimization.