# File Storage Providers {#file-storage-providers}


Configure and use different file storage backends.


## Overview {#overview}


Gauzy supports multiple file storage providers for uploads (images, documents, screenshots):

| Provider     | `FILE_PROVIDER` value | Description            |
| ------------ | --------------------- | ---------------------- |
| Local        | `LOCAL`               | Local filesystem       |
| Amazon S3    | `S3`                  | Amazon S3 / compatible |
| Wasabi       | `WASABI`              | Wasabi Cloud Storage   |
| Cloudinary   | `CLOUDINARY`          | Cloudinary CDN         |
| DigitalOcean | `DIGITALOCEAN_S3`     | DigitalOcean Spaces    |


## Provider Configuration {#provider-configuration}



### Local Storage {#local-storage}


```
FILE_PROVIDER=LOCAL
```

Files are stored in the `apps/api/public/` directory.


### Amazon S3 {#amazon-s3}


```
FILE_PROVIDER=S3
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret
AWS_REGION=us-east-1
AWS_S3_BUCKET=your-bucket
```


### Wasabi {#wasabi}


```
FILE_PROVIDER=WASABI
WASABI_ACCESS_KEY_ID=your-key
WASABI_SECRET_ACCESS_KEY=your-secret
WASABI_REGION=us-east-1
WASABI_SERVICE_URL=https://s3.wasabisys.com
WASABI_S3_BUCKET=your-bucket
```


### Cloudinary {#cloudinary}


```
FILE_PROVIDER=CLOUDINARY
CLOUDINARY_API_KEY=your-key
CLOUDINARY_API_SECRET=your-secret
CLOUDINARY_CLOUD_NAME=your-cloud
```


## Provider Selection in Code {#provider-selection-in-code}


```typescript
import { FileStorageProviderEnum } from "@gauzy/contracts";

// The active provider is determined by FILE_PROVIDER env var
const provider = FileStorageProviderEnum[process.env.FILE_PROVIDER];
```


## Production Recommendation {#production-recommendation}


For production deployments, always use an external storage provider (S3, Wasabi, or Cloudinary) to:

- Support horizontal scaling (multiple API instances)
- Ensure data persistence across container restarts
- Enable CDN delivery for better performance
- Simplify backup strategies


## Related Pages {#related-pages}


- [Image Asset Endpoints](https://sourcey-gauzy.pages.dev/api/image-asset-endpoints/index.md) — upload API
- [Environment Variables](https://sourcey-gauzy.pages.dev/devops/environment-variables/index.md) — configuration