847

Product support

Get help in the plugin support forum.

  • Added on Mar 25, 2026
  • Current version: 1.0.1
  • Platform Compatibility
    v4.x use latest
    v3.x use latest
    v2.x not tested
    v1.x not tested
  • Created by
    Bronze partner

Categories

Deploy Extender adds bidirectional database and storage synchronization to RainLab.Deploy.

Push your local database and files to production, or pull remote data to your development environment — with automatic backups, step-by-step progress logging, and selective sync options.

Features

  • Sync Push (Local → Remote) — Push database, media, and uploads to your remote server
  • Sync Pull (Remote → Local) — Pull remote database, media, and uploads to your local environment
  • Deploy Uploads — Adds upload file deployment to the standard RainLab Deploy workflow
  • Automatic Backups — Full database backup created before every destructive operation
  • Skip Backend Users — Preserve admin accounts on either side during sync
  • Safety Exclusions — Deploy tables, event logs, sessions, cache, and job queues are never synced
  • Step-by-Step Progress — Live progress log showing each operation as it executes
  • Sync History — Full log of all sync operations with status, counts, and backup paths
  • Console Commands — Run sync push, pull, and upload deploy from the command line
  • Remote DB Backup — Download a full database dump from any connected server

Requirements

Installation via Command Line

php artisan plugin:install Pear.DeployExtender

Installation

Install via Composer:

composer require pear/deployextender-plugin

Or install from the October CMS Marketplace.

Requirement: RainLab.Deploy plugin must be installed and configured with at least one server.

Usage

Sync Push (Local → Remote)

  1. Go to Settings → Deploy → Servers and open a server in Manage mode
  2. Click Sync Push: Local → Remote
  3. Select what to sync: Database, Media files, Upload files
  4. Optionally check "Skip Backend Users" to preserve remote admin accounts
  5. Click Start Push Sync and monitor the progress log

Sync Pull (Remote → Local)

  1. Open a server in Manage mode
  2. Click Sync Pull: Remote → Local
  3. Select what to sync and click Start Pull Sync
  4. A local database backup is created automatically before import

Deploy Uploads

When deploying via the standard RainLab Deploy interface, a new Deploy Upload Files checkbox appears. Check it to include storage/app/uploads in the deployment package.

Remote Database Backup

Click Backup Remote DB on any server to download a full database dump (all tables, no exclusions) to storage/app/deploy-backups/.

Console Commands

php artisan deployextender:sync-push {server_id} [--skip-users] [--db] [--media] [--uploads]
php artisan deployextender:sync-pull {server_id} [--skip-users] [--db] [--media] [--uploads]
php artisan deployextender:deploy-uploads {server_id}

Sync Logs

View all sync history at Settings → Deploy Extender → Sync Logs. Each entry shows direction, status, table/file counts, duration, and backup file path.

Excluded Tables

The following tables are always excluded from sync to prevent conflicts:

  • deploy_* (RainLab Deploy tables)
  • sessions, cache, jobs, failed_jobs
  • system_event_logs, system_request_logs

Permissions

  • Manage sync operationspear.deployextender.manage_sync
  • View sync logspear.deployextender.view_logs
1.0.1

Batched storage sync with progress bar for large media/uploads (1GB+).

Mar 22, 2026

1.0.0

Initialize plugin.

Mar 22, 2026

Version 1.0.0

Initial release. No upgrade steps required.