NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #564 most downloaded on Packagist
A Laravel package to backup your application
Latest stable
10.4.0
Last release 16 days ago
06 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
333 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
This release requires PHP 8.4 or newer. PHP 8.3 is no longer supported. The minimum is aligned with the current Pest 5 / PHPUnit 13 test toolchain; th
This release requires PHP 8.4 or newer. PHP 8.3 is no longer supported. The minimum is aligned with the current Pest 5 / PHPUnit 13 test toolchain; this is not a claim that Laravel itself requires PHP 8.4. Laravel 12 and 13 remain supported.
backup:list.Full Changelog: https://github.com/spatie/laravel-backup/compare/10.3.3...10.4.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
An empty BACKUP_ARCHIVE_PASSWORD in your .env now disables encryption, as documented. Previously the empty string was treated as a password, which mad
An empty BACKUP_ARCHIVE_PASSWORD in your .env now disables encryption, as documented. Previously the empty string was treated as a password, which made the backup fail with ZipArchive::close(): Invalid argument.
Thanks to @jeffersongoncalves for tracking this down.
Full Changelog: https://github.com/spatie/laravel-backup/compare/10.3.2...10.3.3
Bump actions/checkout from 4 to 7 by @dependabot[bot] in https://github.com/spatie/laravel-backup/pull/1981
Full Changelog: https://github.com/spatie/laravel-backup/compare/10.3.1...10.3.2
When verify_backup is enabled, the file count of the created archive is now compared against the backup manifest. Previously the expected count was pa
When verify_backup is enabled, the file count of the created archive is now compared against the backup manifest. Previously the expected count was passed to the verification step but never checked, so verification only caught an unopenable or completely empty zip. A truncated archive now fails the backup with a BackupVerificationFailed exception.
Thanks to @gazben for spotting this.
Full Changelog: https://github.com/spatie/laravel-backup/compare/10.3.0...10.3.1
Spatie\Backup\Listeners\EncryptBackupArchive is deprecated and no longer registered. If you registered this listener yourself, remove that registratio…
Previously the archive was written unencrypted and then rewritten with encryption by the EncryptBackupArchive listener, writing large backups to disk twice. Encryption is now applied per file while the zip is built, so the archive is only written once. The configuration (backup.backup.password and backup.backup.encryption) and the resulting archives are unchanged.
Upgrade notes
Spatie\Backup\Listeners\EncryptBackupArchive is deprecated and no longer registered. If you registered this listener yourself, remove that registration. The class is kept and still works for backwards compatibility.backup.backup.encryption to 'none' instead.BackupFailed instead of silently producing an unencrypted archive.Full Changelog: https://github.com/spatie/laravel-backup/compare/10.2.2...10.3.0
The backup:clean command now resolves the cleanup strategy from the config passed via --config instead of always using the default config's strategy (
backup:clean command now resolves the cleanup strategy from the config passed via --config instead of always using the default config's strategy (#1976). Reported in #1975.File::mimeType() (#1977).Fix German translations in notifications.php
Fix German translations in notifications.php
Downgrade PHP requirement from ^8.4 to ^8.3 by @erikn69 in https://github.com/spatie/laravel-backup/pull/1966
Storage include by @ndeblauw in https://github.com/spatie/laravel-backup/pull/1965
Full Changelog: https://github.com/spatie/laravel-backup/compare/10.1.0...10.1.1
Add log_channel config option to control where backup activity logs are written. Set to a channel name to redirect logs, false to disable logging, or
Add log_channel config option to control where backup activity logs are written. Set to a channel name to redirect logs, false to disable logging, or null (default) to keep existing behavior.
Fix callMethodOnDumper treating false config values as no-argument calls
Fix callMethodOnDumper treating false config values as no-argument calls (#1961)
update supported PHP and Laravel in Readme by @hebbet in https://github.com/spatie/laravel-backup/pull/1958
Full Changelog: https://github.com/spatie/laravel-backup/compare/10.0.0...10.0.1
v10 is a major release requiring PHP 8.4+ and Laravel 12+. See the upgrade guide for migration instructions.
v10 is a major release requiring PHP 8.4+ and Laravel 12+. See the upgrade guide for migration instructions.
string $diskName, string $backupName) instead of BackupDestination or BackupDestinationStatus objects — events can now be used with queued listenersconsoleOutput() helper replaced by backupLogger()ConsoleOutput class removedBackupJob::disableNotifications() removed — use EventHandler::disable() insteadCleanupStrategy constructor changed from Repository $config to Config $confignull/false/'default' to 'none'/'default'/'aes128'/'aes192'/'aes256'BackupDestinationStatus::getHealthCheckFailure() replaced by getHealthCheckFailures() (returns a collection)continue_on_failure config optionverify_backup config option)--filename-suffix, --exclude, --destination-pathstorage/framework excluded by defaultCode quality improvements by @freekmurze in https://github.com/spatie/laravel-backup/pull/1956
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.4.0...9.4.1
Add missing continue_on_failure option to config by @BoGnY in https://github.com/spatie/laravel-backup/pull/1943
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.7...9.4.0
Аdd a link to the test icon by @sashaphmn in https://github.com/spatie/laravel-backup/pull/1937
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.6...9.3.7
Fix: allows backups to continue when some destinations fail instead of failing completely by @imhayatunnabi in https://github.com/spatie/laravel-backu
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.5...9.3.6
Update issue template by @AlexVanderbist in https://github.com/spatie/laravel-backup/pull/1916
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.4...9.3.5
Update installation-and-setup.md by @justrau in https://github.com/spatie/laravel-backup/pull/1907
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.3...9.3.4
Correct danish translation for "application" by @mathiaskastrup in https://github.com/spatie/laravel-backup/pull/1906
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.2...9.3.3
Improve port check condition by @miskith in https://github.com/spatie/laravel-backup/pull/1904
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.1...9.3.2
DbDumperFactory: Ignore invalid ports by @CloCkWeRX in https://github.com/spatie/laravel-backup/pull/1901
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.3.0...9.3.1
Update backup.php by @Sairahcaz in https://github.com/spatie/laravel-backup/pull/1895
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.9...9.3.0
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.8...9.2.9
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.8...9.2.9
remove the only() from tests by @pxpm in https://github.com/spatie/laravel-backup/pull/1875
only() from tests by @pxpm in https://github.com/spatie/laravel-backup/pull/1875Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.4...9.2.8
Kazakh language support 🇰🇿 by @altynbek07 in https://github.com/spatie/laravel-backup/pull/1890
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.6...9.2.7
Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/spatie/laravel-backup/pull/1883
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.5...9.2.6
remove the only() from tests by @pxpm in https://github.com/spatie/laravel-backup/pull/1875
only() from tests by @pxpm in https://github.com/spatie/laravel-backup/pull/1875Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.4...9.2.5
[DOCS] Update installation-and-setup.md by @altynbek07 in https://github.com/spatie/laravel-backup/pull/1874
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.3...9.2.4
Fix temp directory config path and add unit test by @NiroDeveloper in https://github.com/spatie/laravel-backup/pull/1872
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.2...9.2.3
feat: add Slovak language by @patressz in https://github.com/spatie/laravel-backup/pull/1870
Slovak language by @patressz in https://github.com/spatie/laravel-backup/pull/1870Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.1...9.2.2
Allow overriding default implementation of TemporaryDirectory by @jonerickson in https://github.com/spatie/laravel-backup/pull/1846
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.2.0...9.2.1
Test PHP 8.4 by @erikn69 in https://github.com/spatie/laravel-backup/pull/1852
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.1.3...9.2.0
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.1.2...9.1.3
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.1.2...9.1.3
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.1.1...9.1.2
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.1.1...9.1.2
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.1.0...9.1.1
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.1.0...9.1.1
Fixing minor typo in Spanish language file. by @chessandrock in https://github.com/spatie/laravel-backup/pull/1822
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.0.4...9.1.0
[9.x] Fix empty string in backup.notifications.discord.username to fail sending a notification by @RVxLab in https://github.com/spatie/laravel-backup/
backup.notifications.discord.username to fail sending a notification by @RVxLab in https://github.com/spatie/laravel-backup/pull/1821Full Changelog: https://github.com/spatie/laravel-backup/compare/9.0.3...9.0.4
Made ext-pcntl optional, as it was in v8. by @den1n in https://github.com/spatie/laravel-backup/pull/1814
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.0.2...9.0.3
[9.x] Add support for both single email string and array of email strings by @vrusua in https://github.com/spatie/laravel-backup/pull/1810
Full Changelog: https://github.com/spatie/laravel-backup/compare/9.0.1...9.0.2
allow null value for config option delete_oldest_backups_when_using_more_megabytes_than in https://github.com/spatie/laravel-backup/commit/ef8b0fab439
delete_oldest_backups_when_using_more_megabytes_than in https://github.com/spatie/laravel-backup/commit/ef8b0fab439b6209ad221a2139a68cd7b67d83ebFull Changelog: https://github.com/spatie/laravel-backup/compare/9.0.0...9.0.1
Add types to the codebase by @Nielsvanpach in https://github.com/spatie/laravel-backup/pull/1799
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.8.1...9.0.0
Chore/ci updates by @Nielsvanpach in https://github.com/spatie/laravel-backup/pull/1798
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.8.1...8.8.2
Normalize and style config file by @siarheipashkevich in https://github.com/spatie/laravel-backup/pull/1791
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.8.0...8.8.1
Add config option database_dump_file_use_connection_name by @jbraband in https://github.com/spatie/laravel-backup/pull/1785
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.7.0...8.8.0
Bump ramsey/composer-install from 2 to 3 by @dependabot in https://github.com/spatie/laravel-backup/pull/1768
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.6.0...8.7.0
Add Support for Laravel 11 by @stefanzweifel in https://github.com/spatie/laravel-backup/pull/1757
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.5.1...8.6.0
Fix duplicate Portuguese translations for backup dates by @ricardo-lobo in https://github.com/spatie/laravel-backup/pull/1752
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.5.0...8.5.1
Fix translations for keys newest_backup_date and oldest_backup_date on tr language by @sdkakcy in https://github.com/spatie/laravel-backup/pull/1743
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.4.1...8.5.0
Improve strategy comments by @iwasherefirst2 in https://github.com/spatie/laravel-backup/pull/1728
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.4.0...8.4.1
Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/spatie/laravel-backup/pull/1716
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.3.4...8.4.0
Move registering events to "booted" rather than "registered" by @modstore in https://github.com/spatie/laravel-backup/pull/1712
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.3.3...8.3.4
Added missing PT and PT/BR translations by @helderneves91 in https://github.com/spatie/laravel-backup/pull/1709
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.3.2...8.3.3
Fix for PhpStan by @erikn69 in https://github.com/spatie/laravel-backup/pull/1695
Command constants instead of integers in commands by @joshbonnick in https://github.com/spatie/laravel-backup/pull/1706Full Changelog: https://github.com/spatie/laravel-backup/compare/8.3.1...8.3.2
bump php version on phpstan.yml by @erikn69 in https://github.com/spatie/laravel-backup/pull/1693
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.3.0...8.3.1
Add a retry feature to the backup and clean commands by @prestamodule in https://github.com/spatie/laravel-backup/pull/1684
backup and clean commands by @prestamodule in https://github.com/spatie/laravel-backup/pull/1684Full Changelog: https://github.com/spatie/laravel-backup/compare/8.2.0...8.3.0
Bump dependabot/fetch-metadata from 1.5.1 to 1.6.0 by @dependabot in https://github.com/spatie/laravel-backup/pull/1681
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.1.11...8.2.0
Fix typo in config by @siarheipashkevich in https://github.com/spatie/laravel-backup/pull/1673
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.1.10...8.1.11
Bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 by @dependabot in https://github.com/spatie/laravel-backup/pull/1663
Full Changelog: https://github.com/spatie/laravel-backup/compare/8.1.9...8.1.10
Updated docs "Installation and setup" by @poldixd in https://github.com/spatie/laravel-backup/pull/1658
CannotCreateDbDumper exception by @dejagersh in https://github.com/spatie/laravel-backup/pull/1661Full Changelog: https://github.com/spatie/laravel-backup/compare/8.1.8...8.1.9
One column per quarter.