PHPackages                             marcusmyers/s3backup - 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. [CLI & Console](/categories/cli)
4. /
5. marcusmyers/s3backup

ActiveLibrary[CLI & Console](/categories/cli)

marcusmyers/s3backup
====================

A command line utility for backing up directories and files to AWS S3

3.0.0(6y ago)1101[1 PRs](https://github.com/marcusmyers/s3backup/pulls)MITPHPPHP ^7.2

Since Sep 27Pushed 5y ago1 watchersCompare

[ Source](https://github.com/marcusmyers/s3backup)[ Packagist](https://packagist.org/packages/marcusmyers/s3backup)[ Docs](https://github.com/marcusmyers/s3backup)[ RSS](/packages/marcusmyers-s3backup/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (6)Versions (6)Used By (0)

S3 Backup
=========

[](#s3-backup)

The `s3backup` cli tool uses a configuration file to setup and backup directories on your computer to S3.

Install
-------

[](#install)

`composer global require "marcusmyers/s3backup=~2.0.0"`

Make sure to place the ~/.composer/vendor/bin directory in your PATH so the s3 executable is found when you run the `s3backup backup` command in your terminal.

Configure
---------

[](#configure)

Once installed on your machine you will need to run `s3backup init` as it should create the following directory `$HOME/.s3backup` and `config.json` file in that directory. Open up the `config.json` file and edit it to your liking, below are a couple examples:

```
{
  "aws": {
    "credentials": {
      "key": "",
      "secret": ""
    },
    "bucket": "my-backup-bucket",
    "file_prefix": "my_backups"
  },
  "filename": "my_laptop_backup",
  "directories": [
    "/Users/exampleUser/Desktop/Logos",
    "/var/www/html",
    "/Users/exampleUser/Documents"
  ]
}
```

```
{
  "aws": {
    "credentials": {
      "key": "",
      "secret": ""
    },
    "bucket": "my-bucket",
    "file_prefix": "my_backups"
  },
  "filename": "my_laptop_backup",
  "directories": []
}
```

Usage
-----

[](#usage)

If you don't setup any directories in the config file you can run backup any folder you want by running the following:

```
s3backup backup path/to/file/or/directory

```

If you have predefined directories in your config file you can simply run:

```
s3backup backup

```

You can also set an environment variable to only have to run `s3backup`like below:

```
export S3_BACKUP_SINGLE_COMMAND=1
s3backup

```

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 55% 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 ~374 days

Total

4

Last Release

2439d ago

Major Versions

1.1.0 → 2.0.02017-03-09

2.0.0 → 3.0.02019-10-26

### Community

Maintainers

![](https://www.gravatar.com/avatar/f71e0894b0f23222260ff8467126f98eb98204b875933a3ac6e03d45c6d60ebe?d=identicon)[marcusmyers](/maintainers/marcusmyers)

---

Top Contributors

[![marcusmyers](https://avatars.githubusercontent.com/u/337947?v=4)](https://github.com/marcusmyers "marcusmyers (71 commits)")[![dependabot-support](https://avatars.githubusercontent.com/u/112581971?v=4)](https://github.com/dependabot-support "dependabot-support (51 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (7 commits)")

---

Tags

aws-s3backupcliphps3awsbackupaws-s3s3backup

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/marcusmyers-s3backup/health.svg)

```
[![Health](https://phpackages.com/badges/marcusmyers-s3backup/health.svg)](https://phpackages.com/packages/marcusmyers-s3backup)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k277.8M965](/packages/league-flysystem-aws-s3-v3)[vinelab/cdn

Content Delivery Network (CDN) Package for Laravel

217242.9k1](/packages/vinelab-cdn)[frostealth/yii2-aws-s3

An Amazon S3 component for Yii2

90710.6k5](/packages/frostealth-yii2-aws-s3)[publiux/laravelcdn

Content Delivery Network (CDN) Package for Laravel

155233.5k](/packages/publiux-laravelcdn)[juhasev/laravelcdn

Content Delivery Network (CDN) Package for Laravel

1820.9k](/packages/juhasev-laravelcdn)

PHPackages © 2026

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