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)16872proprietaryPHP

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 yesterday

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

29

—

LowBetter than 57% of packages

Maintenance27

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity46

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

659d 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

[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[fof/upload

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

191192.5k18](/packages/fof-upload)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1034.8k4](/packages/fof-discussion-language)

PHPackages © 2026

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