RapidMirror is a powerful, production-ready file mirroring platform that allows users to upload files once and automatically mirror them to multiple remote file hosting services.

Built with Laravel 12, React 19, Inertia.js, and Filament 5 admin panel.

• Multi-Host Mirroring - Upload once, distribute to multiple hosts
• Modern React 19 Dashboard - Beautiful, responsive UI with dark mode
• Filament 5 Admin Panel - Complete management dashboard
• Queue-Based Processing - Laravel Horizon for reliable uploads
• Cloud Storage - S3 & Cloudflare R2 support
• RESTful API - Complete API with JS, Python, Dart SDKs included
• User Management - Registration, 2FA, roles, API tokens
• Analytics - Track uploads, views, and performance

• PHP 8.2 or higher
• MySQL 5.7+ or MariaDB 10.3+
• Node.js 18.x or higher
• Composer 2.x
• Redis (recommended for queues)

PHP Extensions: BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, cURL

Works with: Apache, Nginx, LiteSpeed

Hosting: VPS, Dedicated Server, or Laravel-compatible shared hosting (like CloudPanel, Ploi, Forge)

Note: Not for shared hosting.

Installation Guide

1. Upload & Extract

Upload the ZIP file to your web server and extract it:

• Extract to: /var/www/html/rapidmirror (or your preferred location)
• Set permissions:

chmod -R 775 storage bootstrap/cache

2. Create Database

Create a MySQL database and user:

• Database name: rapidmirror
• Create a user with full privileges for this database

3. Configure Environment

• Rename .env.example to .env (or edit the included .env)
• Update database credentials:

DB_DATABASE=rapidmirror
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password

Update the application URL with your domain:

APP_URL=https://your-domain.com

4. Install Dependencies

Run the following commands in the project directory:

composer install --no-dev --optimize-autoloader
npm install

5. Setup Application

Run these commands:

php artisan key:generate
php artisan migrate --seed --force
php artisan storage:link
npm run build

6. Configure Web Server

Point your web server document root to the /public directory.

Example for Nginx:

root /var/www/html/rapidmirror/public;

7. Setup Queue Worker (Required)

Add the following cron job:

* * * * * cd /path-to-project && php artisan schedule:run >> /dev/null 2>&1

Start the queue worker using Supervisor or run:

php artisan queue:work --tries=3 --timeout=900

Alternatively, use Laravel Horizon:

php artisan horizon

8. Login

Admin Panel: https://your-domain.com/admin

Default credentials:

• Email: [email protected]
• Password: password

Quick Install (Alternative)

After extracting the files, run the included install script:

<code>chmod +x install.sh
./install.sh</code>