alveby / atrium-backup
Backups for Atrium: database and files, several destinations, schedules, retention, health checks, restore from the admin
dev-main / 0.1.x-dev
2026-11-17 04:54 UTC
Requires
- php: ^8.3
- ext-zip: *
- alveby/atrium: ^0.1
- illuminate/support: ^13.0
- spatie/laravel-backup: ^10.3
Requires (Dev)
- orchestra/testbench: ^11.0
- phpunit/phpunit: ^12.5
Suggests
- league/flysystem-aws-s3-v3: Backups to Amazon S3 or any S3-compatible storage
- league/flysystem-ftp: Backups to an FTP server
- league/flysystem-sftp-v3: Backups to an SFTP server
- masbug/flysystem-google-drive-ext: Backups to Google Drive
- spatie/flysystem-dropbox: Backups to Dropbox
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 19:17:31 UTC
README
Backups for the Atrium admin, on top of spatie/laravel-backup:
- the databases (MySQL, MariaDB, PostgreSQL, SQLite) in a consistent dump, and the folders you choose, in one compressed zip, encrypted with a password if you give one;
- copied to several places at once: a folder on the server, S3 or any S3-compatible storage, FTP, SFTP, Google Drive, Dropbox;
- daily or weekly, keeping a number of daily, weekly, monthly and yearly copies;
- an e-mail when a backup fails, a destination cannot be reached, the newest archive is too old, or its size jumps;
- a Backups screen for superadmins: the archives with their size and place, Back up now, download, restore with a summary of what will change and a typed confirmation, and a log.
Install
composer require alveby/atrium-backup php artisan atrium:module:install alveby/atrium-backup
Backups run from Laravel's scheduler, so cron must call php artisan schedule:run every minute. The server needs mysqldump/mysql, pg_dump/psql or sqlite3 for the databases you use.
By default the default connection and the admin's uploads go to storage/app/backups every night at 02:00. To add an S3 bucket:
ATRIUM_BACKUP_DESTINATIONS=backups,backup-s3 ATRIUM_BACKUP_S3_KEY=... ATRIUM_BACKUP_S3_SECRET=... ATRIUM_BACKUP_S3_BUCKET=site-backups ATRIUM_BACKUP_PASSWORD=... # keep a copy somewhere other than the server
composer require league/flysystem-aws-s3-v3
Commands
php artisan atrium:backup:run php artisan atrium:backup:restore --dry-run
Everything else, including the risks of a restore and what this package adds to spatie's: docs/backup.md.
License
MIT