Installation

This guide covers installing the Deploy Forge plugin on your WordPress site and completing the initial setup.

System Requirements

WordPress Site

| Requirement | Minimum | Recommended | | ------------------ | ---------- | ----------- | | WordPress | 5.8+ | 6.4+ | | PHP | 7.4+ | 8.2+ | | Memory Limit | 128MB | 256MB | | Max Execution Time | 120s | 300s | | Disk Space | 500MB free | 1GB+ free |

Required PHP Extensions

json - API communication
zip - Artifact extraction
sodium - Credential encryption
curl - HTTP requests

Other Requirements

HTTPS - Required for GitHub webhooks
Write access to wp-content/themes/ directory
WP-Cron enabled (or system cron configured)

Installing the Plugin

Step 1: Download the Plugin

Log in to your Deploy Forge dashboard
Navigate to Downloads
Click Download Plugin to get the latest .zip file

Step 2: Upload to WordPress

In your WordPress admin, go to Plugins → Add New
Click Upload Plugin at the top
Choose the downloaded deploy-forge.zip file
Click Install Now
Click Activate Plugin

Alternative: Manual Installation

# Extract the plugin to your plugins directory
unzip deploy-forge.zip -d /path/to/wordpress/wp-content/plugins/

# Set correct permissions
chmod -R 755 /path/to/wordpress/wp-content/plugins/deploy-forge/

Then activate via Plugins → Installed Plugins in WordPress admin.

Connecting to Deploy Forge

After activating the plugin:

Go to Deploy Forge in your WordPress admin
Click Connect
You'll be redirected to the Deploy Forge app to complete setup:
- Connect your GitHub account
- Select your repository and branch
- Choose your deployment method (GitHub Actions or Direct Clone)
Once complete, you're returned to WordPress and ready to deploy

Verifying Installation

Once connected:

Go to Deploy Forge → Dashboard in WordPress admin
Check that your site shows as Connected
Verify your repository and branch are displayed correctly
Click Deploy Now to trigger a test deployment
Watch the deployment progress in real-time