Installation

1. Upload the Add-on

Copy the ee_push folder into your ExpressionEngine installation's add-ons directory:

Directory structure

system/user/addons/ee_push/
├── addon.setup.php
├── mcp.ee_push.php
├── mod.ee_push.php
├── upd.ee_push.php
├── assets/
├── language/
└── views/

2. Copy Theme Assets

EE Push includes custom CSS and JavaScript for the Control Panel interface. Copy the assets to your themes directory:

Terminal

cp -r system/user/addons/ee_push/assets/ themes/user/ee_push/

Alternatively, create a symlink for easier updates:

Terminal

ln -s ../../system/user/addons/ee_push/assets themes/user/ee_push

3. Install via Control Panel

Log into your ExpressionEngine Control Panel
Navigate to Add-Ons in the sidebar
Find EE Push in the list of uninstalled add-ons
Click Install

This will create the required database tables and default settings.

4. Install SSH Dependencies (Optional)

If you plan to use SSH/SFTP deployments, you need the phpseclib library. Run this from your ExpressionEngine root directory:

Terminal

composer require phpseclib/phpseclib:~3.0

This is not required for Webhook or Plesk deployment targets.

5. Verify Installation

After installation, you should see EE Push in your Control Panel sidebar under Add-Ons. Click it to access the dashboard.

The dashboard will show an empty state prompting you to create your first environment.

Database Tables Created

EE Push creates four tables during installation:

Table	Purpose
`exp_ee_push_environments`	Deployment environment configurations
`exp_ee_push_deployments`	Deployment history and logs
`exp_ee_push_approvals`	Two-person approval workflow records
`exp_ee_push_settings`	Global settings (key-value pairs)

Uninstalling

To uninstall EE Push, go to Add-Ons in the Control Panel, find EE Push, and click Uninstall. This will remove all database tables and data. Make sure to download any deployment backups you want to keep before uninstalling.