File Storage

Stilmerce stores uploaded files (product images, documents) either on the local disk or in Cloudinary.

Local Storage (default)

By default, files are stored on the server's disk under api/uploads/. No additional configuration needed.

USE_CLOUDINARY=false

Local storage is suitable for single-server installs. Files are served through the API at /uploads/.

To store files in Cloudinary instead:

USE_CLOUDINARY=true
CLOUDINARY_CLOUD_NAME=your-cloud-name
CLOUDINARY_API_KEY=your-api-key
CLOUDINARY_API_SECRET=your-api-secret

Get these values from your Cloudinary dashboard.

Cloudinary is recommended when running multiple API instances or when you want a CDN-backed image delivery pipeline.