PHPackages                             ramon/backup - 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. [Database &amp; ORM](/categories/database)
4. /
5. ramon/backup

ActiveFlarum-extension[Database &amp; ORM](/categories/database)

ramon/backup
============

Full backups and one click migration for Flarum 2

v2.0.19(1mo ago)0567↓16.7%[6 PRs](https://github.com/ram0ng1/backup/pulls)MITPHPCI passing

Since May 9Pushed 3w agoCompare

[ Source](https://github.com/ram0ng1/backup)[ Packagist](https://packagist.org/packages/ramon/backup)[ RSS](/packages/ramon-backup/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (6)Versions (27)Used By (0)

 [![Backup & Migration](icon.svg)](icon.svg)

Backup &amp; Migration
======================

[](#backup--migration)

 [![CI](https://camo.githubusercontent.com/466cd17cb1f81a5aba4d126b891b1be38099d2958666ebed26176a2521b0f023/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72616d306e67312f6261636b75702f63692e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265266c6162656c3d6369)](https://github.com/ram0ng1/backup/actions/workflows/ci.yml) [![Packagist](https://camo.githubusercontent.com/0fa30364ea9296239c8a12cf94394f798a0158686180d921cf84579eb53f92b2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72616d6f6e2f6261636b75703f7374796c653d666c61742d737175617265266c6162656c3d7061636b6167697374)](https://packagist.org/packages/ramon/backup) [![Downloads](https://camo.githubusercontent.com/1b4f65cc68070cbc86869ef83bd67ff4de647ebfe39322a42713e9ad3df71440/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72616d6f6e2f6261636b75703f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ramon/backup) [![Flarum](https://camo.githubusercontent.com/a132223aa88aa88b24ad5a6117fada567e8f9ce7e6423e24fbe2d77c9b1b9c64/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c6172756d2d322e782d6537363732653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/a132223aa88aa88b24ad5a6117fada567e8f9ce7e6423e24fbe2d77c9b1b9c64/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c6172756d2d322e782d6537363732653f7374796c653d666c61742d737175617265) [![License](https://camo.githubusercontent.com/ac049ef4e7a0b7196b09add6ac2d4f180e544c0ac779c2b2ac2fd2723a209579/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75653f7374796c653d666c61742d737175617265)](LICENSE) [![Donate](https://camo.githubusercontent.com/26680fc470ae1a7cdffd5e21e44f49eadfd6b9f9358a874c44405609d35ac325/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d7374726970652d3637373245353f7374796c653d666c61742d737175617265)](https://donate.stripe.com/fZe5o66nebkf39S28a)

Full backups and one click migration for Flarum 2.

Backup &amp; Migration packs your whole forum into a single portable `.flarum` file: database, uploads, storage and extensions. Restore it on the same install or on a brand new server and keep going.

I wrote it after one too many rounds of the mysqldump and zip dance while moving forums between hosts. It ended up becoming something close to what All-in-One WP Migration is for WordPress, just built natively for Flarum.

What it does
------------

[](#what-it-does)

- Exports everything into one streaming `.flarum` file, so multi GB forums never need to fit in memory
- Lets you pick what goes in: database, assets, storage and individual extensions
- Restores with per section and per extension checkboxes, resumable in chunks
- Migrates between database engines: export from MySQL, restore on PostgreSQL, MariaDB or SQLite
- Rewrites the forum URL automatically when restoring on a different host
- Encrypts archives with libsodium when you ask it to, including transfers to another server's public key
- Ships `composer.json` and `composer.lock` inside the archive, so vendor extensions stay reproducible

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

[](#installation)

```
composer require ramon/backup
php flarum migrate
php flarum cache:clear
```

Then enable Backup &amp; Migration on the Extensions page of the admin panel.

Command line
------------

[](#command-line)

The same engine runs as console commands, with no HTTP timeout and no browser tab to babysit. Best route for large forums and cron jobs.

```
php flarum backup:export --all                      # everything
php flarum backup:export --db --target=postgres     # database only, retargeted to another engine
php flarum backup:import /backups/forum.flarum --yes
```

A restore replaces the destination data, so `backup:import` refuses to run without `--yes`. Use `--help` on either command for the full list of flags.

About encryption
----------------

[](#about-encryption)

Encrypted archives use a libsodium sealed box wrapping a per archive stream key. The public key lives in the database, the private key only in `config.php`. Keep that private key safe: without it an encrypted archive cannot be opened.

License
-------

[](#license)

[MIT](LICENSE). Found a bug or have an idea? [Open an issue](https://github.com/ram0ng1/backup/issues).

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance93

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80.6% 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

20

Last Release

47d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13917322?v=4)[Ramon Guilherme](/maintainers/ram0ng1)[@ram0ng1](https://github.com/ram0ng1)

---

Top Contributors

[![ram0ng1](https://avatars.githubusercontent.com/u/13917322?v=4)](https://github.com/ram0ng1 "ram0ng1 (75 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (7 commits)")

---

Tags

migrationbackupexportimportflarum

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ramon-backup/health.svg)

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

###  Alternatives

[ddeboer/data-import

Import data from, and export data to, a range of file formats and media

5594.3M9](/packages/ddeboer-data-import)[flarum-lang/russian

Russian language pack for Flarum.

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

Data import/export workflow

2873.0M25](/packages/portphp-portphp)[rah/danpu

Zero-dependency MySQL dump library for easily exporting and importing databases

62414.3k11](/packages/rah-danpu)[cyber-duck/laravel-excel

This package provides a way to export an Eloquent collection as an excel file and to import a Excel file as an Eloquent collection.

74228.6k](/packages/cyber-duck-laravel-excel)[in2code/migration

Framework for any kind of TYPO3 migrations and imports. Also exports and imports content from and to json files.

6382.9k3](/packages/in2code-migration)

PHPackages © 2026

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