PHPackages                             jonnyw/craft-awss3assets - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. jonnyw/craft-awss3assets

ActiveCraft-plugin[File &amp; Storage](/categories/file-storage)

jonnyw/craft-awss3assets
========================

A Craft CMS plugin allowing you to upload assets to an AWS S3 bucket.

v1.2.0(9y ago)101.6k2MITPHPPHP &gt;=5.6.0

Since Nov 21Pushed 9y ago1 watchersCompare

[ Source](https://github.com/jonnnnyw/craft-awss3assets)[ Packagist](https://packagist.org/packages/jonnyw/craft-awss3assets)[ RSS](/packages/jonnyw-craft-awss3assets/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (4)Versions (5)Used By (0)

Craft AWS S3 Assets
===================

[](#craft-aws-s3-assets)

When you upload or replace an asset in the Craft control panel, your asset will be uploaded to your AWS S3 bucket. When you delete an asset, your asset will be deleted from your S3 bucket.

This plugin is useful for serving assets from a CloudFront CDN and makes load balancing your Craft app across multiple server instances, simpler.

[![Total Downloads](https://camo.githubusercontent.com/1ae1dddd9f0f124dcc19092bce0cd423173f8eebfcfbfcaad00afd0bedadba86/68747470733a2f2f706f7365722e707567782e6f72672f6a6f6e6e79772f63726166742d61777373336173736574732f646f776e6c6f6164732e706e67)](https://packagist.org/packages/jonnyw/craft-awss3assets) [![Latest Stable Version](https://camo.githubusercontent.com/8c1e4fbb5621504316d9b772cec49301e7a08e6a59529dd47d7c494d91fe86d4/68747470733a2f2f706f7365722e707567782e6f72672f6a6f6e6e79772f63726166742d61777373336173736574732f762f737461626c652e706e67)](https://packagist.org/packages/jonnyw/craft-awss3assets)

Requirements
------------

[](#requirements)

- PHP 5.6+
- AWS S3 bucket - [Documentation](http://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html)
- AWS CloudFront distribution (optional) - [Documentation](http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/GettingStarted.html)

Installation
------------

[](#installation)

It is recommended that you use [Composer](https://getcomposer.org/) to manage this plugin. If you are not using Composer for your PHP projects then it's worth taking a look at. It can be easily set up for any new or existing project and takes the hassle out of package management.

When you have Composer set up in your project, simply require the AWS S3 Assets package.

```
composer require jonnyw/craft-awss3assets

```

Setup
-----

[](#setup)

### One

[](#one)

After installing the plugin, navigate to `Settings > Plugins` in your Craft control panel. If you have installed the plugin correctly then you should see **AWS S3 Assets** in your plugin list. If you do not see **AWS S3 Assets** listed then ensure that the plugin is install in `~/craft/plugins/awss3assets/`.

### Two

[](#two)

Install the **AWS S3 Assets** plugin using the `install` button in the list. At this point you may receive the following error:

`AWSS3AssetsPlugin could not locate an autoload file`

By default the plugin will look in your sites `~/vendor` folder for an autoload file. This is the default install location for Composer. If you are using a custom Composer location and you haven't already included your `autoload.php` file in Craft, then you will need to do so before enabling this plugin. See the Composer [documentation](https://getcomposer.org/doc/) for more information.

### Three

[](#three)

After the plugin has been successfully installed, navigate to `Settings` in your Craft control panel. You should see **AWS S3 Assets** listed under the Plugins subheading. Here you will find the following settings:

##### Bucket Region

[](#bucket-region)

The AWS region that you created your S3 bucket in e.g. us-east-1. Please ensure the region is the same as your bucket or you will encounter an error.

##### Bucket Name

[](#bucket-name)

The name of your AWS S3 bucket. This is the name your provided when you created your bucket e.g. media.mywebsite.com.

##### Bucket Path (optional)

[](#bucket-path-optional)

Path to upload assets to in your S3 bucket. If left blank it will upload assets to the root of your S3 bucket.

##### AWS Key (optional)

[](#aws-key-optional)

Your IAM user key. The IAM user associated with this key must have read/write access to your AWS S3 bucket.

##### AWS Secret (optional)

[](#aws-secret-optional)

Your IAM user secret. The IAM user associated with this key must have read/write access to your AWS S3 bucket.

**Note** If you are running your Craft application on an EC2 instance that already has access to your S3 bucket, then you can leave the IAM user credentials blank.

### Four (optional)

[](#four-optional)

If you wish to serve your assets from an AWS CloudFront distribution, then you will need to create an asset source that points to CloudFront.

Navigate to `Settings > Assets` in your Craft control panel. Click `New asset source`. Configure your asset source as you normally would with the exception of the URL field. Here you will need to add the URL of your CloudFront distribution. More information can be found on setting up a CloudFront distribution, in the [documentation](http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/GettingStarted.html).

###  Health Score

32

—

LowBetter than 74% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

4

Last Release

3404d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2be603a8f4bf00ee9550368ce8af31dd3155bab0150598b3019a885f48a85594?d=identicon)[jonnyw](/maintainers/jonnyw)

---

Top Contributors

[![jonnnnyw](https://avatars.githubusercontent.com/u/5824499?v=4)](https://github.com/jonnnnyw "jonnnnyw (20 commits)")

---

Tags

s3awsassetsCraft

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jonnyw-craft-awss3assets/health.svg)

```
[![Health](https://phpackages.com/badges/jonnyw-craft-awss3assets/health.svg)](https://phpackages.com/packages/jonnyw-craft-awss3assets)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k257.1M684](/packages/league-flysystem-aws-s3-v3)[aws/aws-sdk-php-laravel

A simple Laravel 6/7/8/9/10/11/12 service provider for including the AWS SDK for PHP.

1.7k34.8M69](/packages/aws-aws-sdk-php-laravel)[aws/aws-sdk-php-resources

A resource-oriented API for interacting with AWS services

1381.8M9](/packages/aws-aws-sdk-php-resources)[vinelab/cdn

Content Delivery Network (CDN) Package for Laravel

221239.8k1](/packages/vinelab-cdn)[aws/aws-sdk-php-zf2

Zend Framework 2 Module that allows easy integration the AWS SDK for PHP

104994.2k4](/packages/aws-aws-sdk-php-zf2)[frostealth/yii2-aws-s3

An Amazon S3 component for Yii2

92691.1k3](/packages/frostealth-yii2-aws-s3)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
