Back to plugins & integrations

AWS S3 icon

AWS S3

Store images and other assets in AWS S3

npm install @vendure/asset-server-plugin

Integration type

Core
Core open-source plugins built by the Vendure team

Category

Storage

Last published

3 days ago

Downloads in past month

13,672
README.md

Prerequisite

The AssetServerPlugin is part of a standard Vendure installation, but if it is not already installed, you must install it:

npm install @vendure/asset-server-plugin

Install AWS SDKs

Before using this strategy, make sure you have the @aws-sdk/client-s3 and @aws-sdk/lib-storage package installed:

npm install @aws-sdk/client-s3 @aws-sdk/lib-storage

Configure the AssetServerPlugin for S3

import { AssetServerPlugin, configureS3AssetStorage } from '@vendure/asset-server-plugin';
import { DefaultAssetNamingStrategy } from '@vendure/core';
import { fromEnv } from '@aws-sdk/credential-providers';

// ...

plugins: [
  AssetServerPlugin.init({
    route: 'assets',
    assetUploadDir: path.join(__dirname, 'assets'),
    namingStrategy: new DefaultAssetNamingStrategy(),
    storageStrategyFactory: configureS3AssetStorage({
      bucket: 'my-s3-bucket',
      credentials: fromEnv(), // or any other credential provider
      nativeS3Configuration: {
        region: process.env.AWS_REGION,
      },
    }),
}),

Complete documentation

See the S3AssetStorageStrategy docs for full documentation.