EE Push Documentation

EE Push is a deployment management add-on for ExpressionEngine 7. It lets you deploy code, run database migrations, and manage multiple environments — all from within the EE Control Panel.

Key Features

  • Three deployment targets — Webhook, SSH/SFTP, and Plesk Git
  • Multiple environments — Configure dev, staging, and production independently
  • Pre-flight checks — Verify disk space, DB connectivity, and branch before deploying
  • Automatic backups — Database dump before every deployment
  • Health checks — HTTP verification after deployment completes
  • One-click rollback — Restore from any deployment backup
  • Two-person approval — Optional approval workflow for production
  • Maintenance mode — Toggle EE system on/off during deployments
  • Full audit log — Complete deployment history with filtering
  • Encrypted credentials — SSH keys and API tokens stored securely

Getting Started

  1. Install the add-on into your ExpressionEngine 7 site
  2. Create an environment (e.g., Production, Staging)
  3. Configure your deployment target: Webhook, SSH, or Plesk
  4. Deploy with a single click

Requirements

  • ExpressionEngine 7.0.0 or later
  • PHP 8.0 or later
  • For SSH deployments: phpseclib/phpseclib ~3.0 (via Composer)
  • For backups: mysqldump available on the server