WordPress Template for Quant Cloud

A production-ready WordPress template designed for deployment on Quant Cloud. This template uses a secure Apache+PHP base image with multi-stage builds to incorporate WordPress functionality while maintaining security and compatibility.

Features

• WordPress Latest: Uses secure Apache+PHP base with WordPress functionality from official images
• Standard Configuration: Uses WordPress's built-in wp-config-docker.php with environment variable mapping
• Quant Cloud Integration: Maps Quant Cloud's DB_* variables to WordPress standards
• Production Ready: Includes health checks, proper file permissions, and security considerations
• WP-CLI Included: WordPress CLI tool pre-installed and configured
• Privileged Port Binding: Apache runs as root for port 80, workers run as www-data for security
• CI/CD Integration: GitHub Actions workflow for automated building and deployment
• Multi-Registry Support: Pushes to both GitHub Container Registry and Quant Cloud Registry
• Database Ready: Works with Quant Cloud's managed database service

Deployment to Quant Cloud

This template provides two deployment options depending on your needs:

🚀 Quick Start (Recommended)

Use our pre-built image - Perfect for most users who want WordPress running quickly without customization.

1. Import Template: In Quant Dashboard, create a new application and import this docker-compose.yml directly
2. Image Source: The "Public Registry" image (ghcr.io/quantcdn-templates/app-wordpress:latest) will automatically be provided and used by default
3. Deploy: Save the application - your WordPress site will be live in minutes!

What you get:

• ✅ Latest WordPress version
• ✅ Automatic updates via our maintained image
• ✅ Zero configuration required
• ✅ Production-ready setup
• ✅ Works with Quant Cloud's managed database

⚙️ Advanced (Custom Build)

Fork and customize - For users who need custom plugins, themes, or configuration.

Step 1: Get the Template

• Click "Use this template" on GitHub, or fork this repository
• Clone your new repository locally

Step 2: Setup CI/CD Pipeline

Add these secrets to your GitHub repository settings:

• QUANT_API_KEY - Your Quant Cloud API key
• QUANT_ORGANIZATION - Your organization slug (e.g., "my-company")
• QUANT_APPLICATION - Your application name (e.g., "my-wordpress-site")

Step 3: Remove Public Registry CI

Since you'll be using your own registry, delete the public build file:

rm .github/workflows/ci.yml

Step 4: Create Application

1. In Quant Cloud, create a new application
2. Import your docker-compose.yml
3. Select "Internal Registry" when prompted
4. This will use your custom built image from the Quant Cloud private registry

Step 5: Deploy

• Push to master branch → Production deployment
• Push to develop branch → Staging deployment
• Create tags → Tagged releases

What you get:

• ✅ Full customization control
• ✅ Your own Docker registry
• ✅ Automated builds on git push
• ✅ Staging and production environments
• ✅ Version tagging support

---

Local Development

For both deployment options, you can develop locally using either Docker Compose or DDEV:

Option 1: Docker Compose

1. Clone your repo (or this template)
2. Use overrides (required for local development):

   ls docker-compose.override.yml

   Note: This override enables testing of entrypoint scripts (like 00-set-document-root.sh) that normally run via Quant Cloud's platform wrapper. Required for proper local development environment.

3. Start services:

   docker compose up -d

4. Access WordPress at http://localhost and run through installation
5. Add Standard Plugins and Themes

   docker compose exec wordpress wp plugin install quant --activate --allow-root
   docker compose exec wordpress wp theme install twentytwentyfive --activate --allow-root

Option 2: DDEV (Recommended for Developers)

1. Clone your repo (or this template)
2. Install DDEV: https://ddev.readthedocs.io/en/stable/users/install/
3. Start DDEV:

   ddev start

4. Access WordPress at the provided DDEV URL and run through installation
5. Add Standard Plugins and Themes

   ddev wp plugin install akismet quant --activate
   ddev wp theme install twentytwentyfive --activate

6. Use DDEV Tools DDEV provides additional developer tools like Xdebug, WP-CLI integration, and automatic WordPress setup. See .ddev/README.md for details.

Local vs Quant Cloud:

Feature	Local Development	Quant Cloud
Database	MySQL container	Managed RDS
Environment	docker-compose.override.yml	Platform variables
Storage	Local volumes	EFS persistent storage
Scaling	Single container	Auto-scaling
Debug	Enabled by default	Production optimized
Access	localhost	Custom domains + CDN

Environment Variables

Database Configuration (Automatic)

These are automatically provided by Quant Cloud:

• DB_HOST - Database host
• DB_DATABASE - Database name
• DB_USERNAME - Database username
• DB_PASSWORD - Database password

Optional WordPress Configuration

• WORDPRESS_TABLE_PREFIX - Table prefix (default: wp_)
• WORDPRESS_DEBUG - Enable debug mode (default: false)
• WP_CONFIG_EXTRA - Additional PHP configuration

Example:

export WP_CONFIG_EXTRA="define('WP_MEMORY_LIMIT', '256M'); define('UPLOAD_MAX_FILESIZE', '64M');"

WP-CLI Support

This template includes WP-CLI (WordPress Command Line Interface) pre-installed and configured.

Local Development

Docker Compose

docker compose exec wordpress wp --info --allow-root
docker compose exec wordpress wp core version --allow-root
docker compose exec wordpress wp plugin list --allow-root

DDEV

ddev wp --info
ddev wp core version
ddev wp plugin list

Quant Cloud (via SSH/exec)

wp --info --allow-root
wp core version --allow-root
wp plugin list --allow-root
wp plugin install akismet quant --activate --allow-root
wp theme install twentytwentyfive --activate --allow-root

WP-CLI automatically inherits the environment variables and database configuration, so it works seamlessly with both local and production environments.

Troubleshooting

Common Issues

1. Error Establishing a Database Connection

   • You might get this error when going to localhost
   • Docker Compose might not be ready, so reload page after a few seconds
   • If the error persists, see the next item

2. Database Connection Failed

   • Check DB_HOST, DB_USERNAME, DB_PASSWORD values
   • Verify database service is running (Quant Cloud manages this)
   • Check network connectivity

3. Environment Variables Not Working

   • Verify variable names match Quant Cloud standards (DB_*)
   • Check container logs for environment mapping output
   • Ensure variables are set in deployment environment

4. Health Check Failures

   • Check WordPress is fully started (60s start period)
   • Verify Apache is running
   • Check resource limits

5. Port Conflicts

   • For docker compose, you may see ports are not available errors
   • If you are running DDEV, turn it off with ddev poweroff
   • If you are running another app, turn it off with docker compose -p app-name down
   • If using DDEV after docker compose, you will need to turn off the app with the same port or run docker compose stop

6. Restarting Local

Docker Compose

docker compose down -v
docker compose up -d

`**DDEV**
```bash
ddev restart
`
or
```bash
ddev delete wordpress-template
ddev start
`

### Logs

View container logs:

**Docker Compose**
```bash
docker compose logs -f wordpress

DDEV

ddev logs -f

Debug Mode

Enable debug mode:

export WORDPRESS_DEBUG=true
export WORDPRESS_DEBUG_LOG=true

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with both local development and Quant Cloud deployment
5. Submit a pull request

Reporting a Vulnerability

Please email security@quantcdn.io with details. Do not open a public issue for security vulnerabilities.

License

This template is released under the MIT License. See LICENSE file for details.

Support

For issues and questions:

• GitHub Issues: Create an issue
• Documentation: Quant Cloud Documentation