Storage Providers

SOLID supports multiple storage providers for media files, offering flexibility in how and where your media assets are stored.

In your current setup, users generally work with three provider options:

private-filesystem
default-filesystem
default-aws-s3

Supported Providers

Filesystem Providers

Description: Store files directly on the server's filesystem
Use Case: Development environments, internal deployments, local/private file storage
Common Options: default-filesystem and private-filesystem
Configuration:

{
  "provider": "local",
  "config": {
    "rootPath": "/path/to/uploads",
    "baseUrl": "http://your-domain.com/uploads"
  }
}

Amazon S3

Description: Store files in Amazon S3 buckets
Use Case: Production environments, scalable applications
Common Option: default-aws-s3
Configuration:

{
  "provider": "s3",
  "config": {
    "bucket": "your-bucket-name",
    "region": "us-west-2",
    "accessKeyId": "YOUR_ACCESS_KEY",
    "secretAccessKey": "YOUR_SECRET_KEY"
  }
}

Which Option Should The User Pick?

Choose private-filesystem when the file must stay private on local storage.
Choose default-filesystem for normal filesystem uploads.
Choose default-aws-s3 when the file should be stored in S3.

If you want private local-file behavior, the media field should use private-filesystem.

Best Practices

Organization

Use clear folder names
Maintain consistent structure
Apply relevant tags
Update metadata regularly

Performance

Optimize file sizes
Use appropriate formats
Limit folder sizes
Regular cleanup

Security

Set proper permissions
Use secure sharing
Monitor access
Regular audits

Workflow

Document naming conventions
Define folder structure
Establish backup procedures
Create usage guidelines