Deploying

Once you have an environment configured, deploying is a single-click operation from the EE Push dashboard.

Starting a Deployment

  1. Navigate to Add-Ons > EE Push
  2. On the dashboard, click Deploy Now on the environment card — or go to Environments and click Deploy next to the environment
  3. Review the deployment form
  4. Click Deploy Now to confirm

Deployment Options

The deploy form offers several options:

OptionDescription
BranchThe Git branch to deploy. Defaults to the environment's configured branch.
Maintenance ModeToggle EE's system offline during the deployment. Recommended for production.
Skip BackupSkip the pre-deployment database backup. Not recommended.
Skip Health CheckSkip the post-deployment health check. Only shown if a health check URL is configured.
NotesOptional deployment notes for the audit log.

What Happens During Deployment

EE Push executes the following steps in order:

  1. Pre-flight checks — Verifies disk space, database connectivity, and deployment target configuration
  2. Backup — Creates a database dump using mysqldump (unless skipped)
  3. Maintenance mode — Sets EE's is_system_on to "n" (if enabled)
  4. Deploy — Executes the deployment via the configured target (Webhook, SSH, or Plesk)
  5. Health check — Sends an HTTP GET to the health check URL and verifies a 200 response
  6. Maintenance mode off — Restores is_system_on to "y"

If any step fails, the deployment is marked as failed and maintenance mode is automatically restored.

Live Progress

After clicking Deploy, the form is replaced with a live progress view showing:

  • A progress bar estimating completion
  • A real-time log viewer showing deployment output
  • Status updates as each step completes

The page polls the server every 2 seconds for status updates. You can safely navigate away — the deployment continues in the background and results are logged.

Approval Workflow

If two-person approval is enabled in Settings, deployments to non-staging environments require a second person to approve before execution begins.

  1. Person A clicks Deploy Now — deployment is created with pending status
  2. Person B sees the pending deployment and clicks Approve
  3. The deployment then executes normally

Deployment Statuses

StatusMeaning
pendingAwaiting approval (if approval workflow is enabled)
approvedApproved but not yet started
runningDeployment in progress
successDeployment completed successfully
failedDeployment failed — check the log for details
rolled_backDeployment was rolled back to a previous state