Strapi Provider Upload S3

• Provider for Strapi upload plugin
• By default is configured to be used with Timeweb S3 storage, but could be used with most S3 storage providers that support AWS SDK - just change the endpoint to the url given by your provider
• Uses AWS SDK v3
• Private buckets support

For more information on how to setup providers in Strapi, visit Strapi Documentation.

Installation

Install package in your Strapi application:

npm i strapi-provider-upload-timeweb or yarn add strapi-provider-upload-timeweb

Configuration

1. Add variables to .env file:

# Required
S3_ACCESS_KEY=access_key
S3_SECRET_KEY=your_secret_access_key
S3_BUCKET=bucket_name

# Optional
S3_URL=https://custom.domain
S3_REGION=ru-1
S3_PRIVATE=true

2. Add configuration options in config/plugins:

JavaScript

module.exports = ({ env }) => ({
 upload: {
  config: {
   provider: 'strapi-provider-upload-timeweb',
    providerOptions: {
     key: env('S3_ACCESS_KEY'),
     secret: env('S3_SECRET_KEY'),
     endpoint: env('S3_URL'),
     region: env('S3_REGION'),
     bucket: env('S3_BUCKET'),
     private: env('S3_PRIVATE', false)
    },
   },
 },
})

TypeScript

export default ({ env }) => ({
upload: {
 config: {
  provider: 'strapi-provider-upload-timeweb',
   providerOptions: {
    key: env('S3_ACCESS_KEY'),
    secret: env('S3_SECRET_KEY'),
    endpoint: env('S3_URL'),
    region: env('S3_REGION'),
    bucket: env('S3_BUCKET'),
    private: env('S3_PRIVATE', false)
   },
  },
 },
})

You can change names of environment variables in .env file and plugins.ts/plugin.js, but keys must be as provided.

Links

• Source code available at GitHub

• NPM package page