Vaultix - Advanced Multi-Storage Backup System for Laravel

Vaultix is a sophisticated, secure, and professional backup management package for Laravel (v10 - v13). It provides a full-featured administrative dashboard to manage multiple storage providers, track backup health, and maintain a detailed audit trail of all administrative activities.

🚀 Key Features

• Multi-Provider Support: Seamlessly integrate with Google Drive, AWS S3, Cloudflare R2, and SFTP.
• Smart Activity Logging: Full audit trail with "Line-by-Line" diff highlighting (Git-style) for all configuration changes.
• Security:
  • Access restricted to Super Admin and authorized emails.
  • Signed URL protection for secure streamed downloads.
  • No direct storage links exposed.
• Smart Projection: Automatically calculates estimated storage usage and file counts based on your retention policies.
• Automated Maintenance:
  • Integrated scheduler for automatic backups.
  • Self-pruning logs (automatically deletes old activity logs based on your retention settings).
• Data Mobility: Export/Import entire configurations and download activity logs in CSV/JSON formats.
• Real-time Monitoring: Disk usage alerts, scheduler health checks, and queue worker status.

📋 Requirements & Dependencies

Vaultix leverages several industry-standard packages to ensure reliability and performance:

• PHP: ^8.2 | ^8.3 | ^8.4
• Laravel: ^10.0 | ^11.0 | ^12.0 | ^13.0

Core Dependencies

These packages are automatically installed with Vaultix:

• spatie/laravel-backup: For the robust core backup engine.
• masbug/flysystem-google-drive-ext: For Google Drive integration.
• league/flysystem-aws-s3-v3: For AWS S3 and Cloudflare R2 support.
• league/flysystem-sftp-v3: For secure SFTP storage.

🛠 Installation

1. Install via Composer:

   composer require codexalta/vaultix

2. Install Vaultix: Run the interactive installation command which will automatically publish configurations, run migrations, and prompt you to restart your queue worker:

   php artisan vaultix:install

3. Environment Setup: Add the following to your .env file to define the Super Admin and optional disk monitoring path:

   VAULTIX_SUPER_ADMIN=your-email@example.com
   
   # Optional: Set this if your project runs in WSL or Docker and you want to monitor a specific partition (e.g., /mnt/c or /)
   # VAULTIX_DISK_PATH=/mnt/c

⚙️ Configuration

Vaultix allows you to manage most settings directly from the dashboard, but you should ensure your Laravel Scheduler and Queue Worker are running:

# Add this to your server's crontab
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

# Ensure queue worker is active for background backups
php artisan queue:work

🔐 Security & Auditing

Vaultix is designed with security as the top priority:

• Activity Logs: Every action (Add storage, Update Job, Download file) is recorded with User IP, User Agent, and a detailed "Before/After" snapshot of data.
• Signed Downloads: All backup downloads are generated as temporary signed URLs and streamed through the server to prevent storage link leakage.
• Access Control: Only the user defined in VAULTIX_SUPER_ADMIN can manage authorized users and view sensitive activity logs.

📊 Exporting Logs

You can export your audit logs directly from the dashboard:

• CSV: Perfect for Excel/Spreadsheet auditing.
• JSON: Ideal for developers and third-party integrations.

🧪 Testing

composer test

(Or run vendor/bin/phpunit directly)

🤝 Contributing

Contributions are welcome! If you find a bug or want to add a feature, please open an issue or submit a pull request.

🛡️ Security Vulnerabilities

If you discover a security vulnerability within Vaultix, please send an e-mail to codexalta@gmail.com. All security vulnerabilities will be promptly addressed.

📄 License

The MIT License (MIT). Please see License File for more information.