PHPackages                             blomstra/s3-assets - 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 & Storage](/categories/file-storage)
4. /
5. blomstra/s3-assets

ActiveFlarum-extension[File & Storage](/categories/file-storage)

blomstra/s3-assets
==================

Relocate Flarum disks onto S3 or compatible bucket

0.1.2(2y ago)15181proprietaryPHP

Since Jul 27Pushed 1y ago4 watchersCompare

[ Source](https://github.com/blomstra/flarum-ext-s3-assets)[ Packagist](https://packagist.org/packages/blomstra/s3-assets)[ Docs](https://blomstra.net)[ RSS](/packages/blomstra-s3-assets/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (19)Used By (0)

S3 Assets
=========

[](#s3-assets)

A [Flarum](http://flarum.org) extension. Relocate Flarum disks onto S3 or compatible bucket

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

[](#installation)

Install with composer:

```
composer require blomstra/s3-assets:"*"
```

Updating
--------

[](#updating)

```
composer update blomstra/s3-assets
php flarum cache:clear
```

Configuration
-------------

[](#configuration)

The S3 (or compatible) bucket can be configured either by environment variables or via the extension settings. If the environment variables are set, they will override the settings entered in the admin panel, if set.

#### Environment variables

[](#environment-variables)

- `AWS_ACCESS_KEY_ID` - your access key ID
- `AWS_SECRET_ACCESS_KEY` - your secret
- `AWS_DEFAULT_REGION` - the region
- `AWS_BUCKET` - the bucket name
- `AWS_URL` - the public facing base URL of the bucket
- `AWS_ENDPOINT` - the ARN
- `AWS_ACL` - The ACL, if any, that should be applied to the uploaded object (default: private). For possible values, see [AWS Docs](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl)
- `AWS_PATH_STYLE_ENDPOINT` - boolean value

If you plan to setup the S3 configuration using the environment variables, please ensure these are set *before* enabling the extension

#### Transferring assets from the existing filesystem to the S3 bucket

[](#transferring-assets-from-the-existing-filesystem-to-the-s3-bucket)

After your new bucket is configured, any exisiting files, will not exist there (ie uploaded avatars, profile covers, etc).

Use the provided command to start moving these files:

```
php flarum s3:move
```

Links
-----

[](#links)

- [Extiverse](https://extiverse.com/extension/blomstra/s3-assets)
- [Discuss](https://discuss.flarum.org/d/PUT_DISCUSS_SLUG_HERE)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance29

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 51.4% 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 ~48 days

Recently: every ~112 days

Total

17

Last Release

603d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/504687?v=4)[Daniël Klabbers](/maintainers/Luceos)[@luceos](https://github.com/luceos)

---

Top Contributors

[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (19 commits)")[![luceos](https://avatars.githubusercontent.com/u/504687?v=4)](https://github.com/luceos "luceos (11 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (6 commits)")[![davwheat](https://avatars.githubusercontent.com/u/7406822?v=4)](https://github.com/davwheat "davwheat (1 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/blomstra-s3-assets/health.svg)

```
[![Health](https://phpackages.com/badges/blomstra-s3-assets/health.svg)](https://phpackages.com/packages/blomstra-s3-assets)
```

###  Alternatives

[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

188171.7k15](/packages/fof-upload)[livetyping/hermitage

RESTful image server

332.8k1](/packages/livetyping-hermitage)

PHPackages © 2026

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