feat: Add automatic droplet resizing and increase default to 2GB

- Add automatic size detection and resizing in deploy.sh
- Change default VPS size from 1GB to 2GB (prevents OOM crashes)
- Add comprehensive system requirements section to README
- Document memory requirements for MySQL 8.0 + Mautic
- Add troubleshooting guide for OOM-related issues
- Update action.yml description with minimum size recommendation

Breaking: Default VPS size changed from s-1vcpu-1gb to s-1vcpu-2gb
This prevents database crashes that occur after a few days on 1GB droplets.

Closes: Out of memory issues with MySQL 8.0 on small droplets

Author: escopecz

README.md

@@ -6,6 +6,7 @@ A GitHub Action to automatically deploy Mautic (open-source marketing automation
 
 - 🚀 **One-click deployment** - Deploy Mautic in minutes, not hours
 - 🖥️ **Automatic VPS creation** - Creates and configures DigitalOcean droplets
+- 📏 **Smart resizing** - Automatically resizes droplets when you change vps-size in config
 - 🔒 **SSL/HTTPS support** - Automatic Let's Encrypt SSL certificates (when domain provided)
 - 🐳 **Docker-based** - Reliable, containerized deployment with Apache
 - 📧 **Email ready** - Pre-configured for email marketing campaigns
@@ -16,6 +17,27 @@ A GitHub Action to automatically deploy Mautic (open-source marketing automation
 
 ## 🚀 Quick Start
 
+## 📋 System Requirements
+
+**Minimum Recommended VPS Size:** `s-1vcpu-2gb` (2GB RAM, $12/month)
+
+⚠️ **Important:** Mautic with MySQL 8.0 requires at least 2GB RAM for stable operation:
+- MySQL 8.0 baseline: ~400-500MB RAM
+- Mautic application: ~300-400MB RAM  
+- OS and services: ~200-300MB RAM
+- Growth buffer for database and cache: ~500MB
+
+**Using a 1GB droplet will cause crashes** after a few days as:
+- Database grows with contacts/campaigns
+- Cron jobs increase memory pressure
+- MySQL gets OOM-killed, corrupting the database
+- System becomes unstable even with swap space
+
+💡 **Recommended sizes by usage:**
+- **Small/Testing:** `s-1vcpu-2gb` (up to 5K contacts)
+- **Medium:** `s-2vcpu-4gb` (up to 50K contacts)
+- **Large:** `s-4vcpu-8gb` (50K+ contacts)
+
 ### 1. Prerequisites
 
 - DigitalOcean account with API token (see required permissions below)
@@ -142,7 +164,7 @@ jobs:
 
 | Parameter | Description | Default | Example |
 |-----------|-------------|---------|---------|
-| `vps-size` | DigitalOcean droplet size | `s-2vcpu-2gb` | `s-4vcpu-8gb` |
+| `vps-size` | DigitalOcean droplet size (automatically resizes if changed) | `s-2vcpu-2gb` | `s-4vcpu-8gb` |
 | `vps-region` | DigitalOcean region | `nyc1` | `fra1`, `lon1`, `sgp1` |
 | `domain` | Custom domain name | _(uses IP)_ | `mautic.example.com` |
 | `mautic-version` | Mautic Docker image version | `6.0.5-apache` | `6.0.4-apache` |
@@ -448,7 +470,23 @@ Error: Permission denied (publickey)
 - Use an SSH key without a passphrase for automation
 - Check the action logs for debugging information about key verification
 
-**3. Domain Not Pointing to Server**
+**3. Mautic Site Offline - "Currently offline due to error"**
+```
+The site is currently offline due to encountering an error.
+```
+**Common Causes:**
+- **Out of Memory (OOM)**: Most common on 1GB droplets after a few days
+  - MySQL 8.0 requires ~400-500MB baseline memory
+  - Database growth + cron jobs can exceed available RAM
+  - **Solution**: Update `vps-size` to `s-1vcpu-2gb` or larger in your workflow YAML and re-run the action
+  - The action will automatically resize your droplet with minimal downtime
+- **Database Corruption**: From repeated OOM kills or power issues
+  - Check logs: `docker logs mautic_db --tail 50`
+  - May need to restore from backup or recreate
+- **Cache Issues**: Corrupted cache files
+  - SSH into server: `docker exec mautic_web rm -rf /var/www/html/var/cache/*`
+
+**4. Domain Not Pointing to Server**
 ```
 Error: Domain example.com does not point to VPS IP
 ```

action.yml

@@ -40,9 +40,9 @@ inputs:
     required: false
     default: 'mautic-vps'
   vps-size:
-    description: 'DigitalOcean droplet size (s-1vcpu-1gb, s-1vcpu-2gb, s-2vcpu-2gb, s-2vcpu-4gb, s-4vcpu-8gb)'
+    description: 'DigitalOcean droplet size - Minimum s-1vcpu-2gb recommended for MySQL 8.0 + Mautic (s-1vcpu-2gb, s-2vcpu-2gb, s-2vcpu-4gb, s-4vcpu-8gb)'
     required: false
-    default: 's-1vcpu-1gb'
+    default: 's-1vcpu-2gb'
   vps-region:
     description: 'DigitalOcean region'
     required: false

scripts/deploy.sh

@@ -107,6 +107,34 @@ if ! doctl compute droplet list | grep -q "${INPUT_VPS_NAME}"; then
     sleep 30
 else
     echo "✅ VPS '${INPUT_VPS_NAME}' already exists"
+    
+    # Check if droplet size matches desired size
+    echo "🔍 Checking if droplet size matches desired configuration..."
+    CURRENT_SIZE=$(doctl compute droplet get "${INPUT_VPS_NAME}" --format Size --no-header)
+    
+    if [ "$CURRENT_SIZE" != "${INPUT_VPS_SIZE}" ]; then
+        echo "⚠️  Droplet size mismatch detected!"
+        echo "   Current size: ${CURRENT_SIZE}"
+        echo "   Desired size: ${INPUT_VPS_SIZE}"
+        echo "🔄 Resizing droplet to ${INPUT_VPS_SIZE}..."
+        echo "   Note: This will cause a brief downtime (typically 1-2 minutes)"
+        
+        # Get droplet ID
+        DROPLET_ID=$(doctl compute droplet get "${INPUT_VPS_NAME}" --format ID --no-header)
+        
+        # Perform resize with disk scaling
+        if doctl compute droplet-action resize "$DROPLET_ID" --size "${INPUT_VPS_SIZE}" --wait; then
+            echo "✅ Droplet resized successfully"
+            echo "⏳ Waiting for droplet to stabilize..."
+            sleep 30
+        else
+            echo "❌ Error: Failed to resize droplet"
+            echo "   Please resize manually in DigitalOcean console or check droplet status"
+            exit 1
+        fi
+    else
+        echo "✅ Droplet size is correct: ${CURRENT_SIZE}"
+    fi
 fi
 
 # Get VPS IP