Deploying
Once you have an environment configured, deploying is a single-click operation from the EE Push dashboard.
Starting a Deployment
- Navigate to Add-Ons > EE Push
- On the dashboard, click Deploy Now on the environment card — or go to Environments and click Deploy next to the environment
- Review the deployment form
- Click Deploy Now to confirm
Deployment Options
The deploy form offers several options:
| Option | Description |
|---|---|
| Branch | The Git branch to deploy. Defaults to the environment's configured branch. |
| Maintenance Mode | Toggle EE's system offline during the deployment. Recommended for production. |
| Skip Backup | Skip the pre-deployment database backup. Not recommended. |
| Skip Health Check | Skip the post-deployment health check. Only shown if a health check URL is configured. |
| Notes | Optional deployment notes for the audit log. |
What Happens During Deployment
EE Push executes the following steps in order:
- Pre-flight checks — Verifies disk space, database connectivity, and deployment target configuration
- Backup — Creates a database dump using
mysqldump(unless skipped) - Maintenance mode — Sets EE's
is_system_onto "n" (if enabled) - Deploy — Executes the deployment via the configured target (Webhook, SSH, or Plesk)
- Health check — Sends an HTTP GET to the health check URL and verifies a 200 response
- Maintenance mode off — Restores
is_system_onto "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.
- Person A clicks Deploy Now — deployment is created with
pendingstatus - Person B sees the pending deployment and clicks Approve
- The deployment then executes normally
Deployment Statuses
| Status | Meaning |
|---|---|
pending | Awaiting approval (if approval workflow is enabled) |
approved | Approved but not yet started |
running | Deployment in progress |
success | Deployment completed successfully |
failed | Deployment failed — check the log for details |
rolled_back | Deployment was rolled back to a previous state |