84b6f2ad0c
Fixing TSG formatting |
||
|---|---|---|
| ARM_Template_Create_WP | ||
| Bicep_Script_Create_WP | ||
| Plugins/app_service_email | ||
| Terraform_Script_Create_WP | ||
| WordPress | ||
| Wordpress_Windows | ||
| .gitignore | ||
| BLOG_POSTS.md | ||
| CODE_OF_CONDUCT.md | ||
| LICENSE | ||
| README.md | ||
| SECURITY.md | ||
| SUPPORT.md | ||
| TODO.md | ||
| Wordpress on Azure App Service_Optimizations_whitepaper.pdf | ||
README.md
WordPress on Azure App Service
🔍 Overview
Whether you're handling a few thousand visitors daily on your eCommerce platform or drawing in large crowds to your content, it's essential that your site is fast and always available to keep your audience engaged. Our cloud solutions ensure high availability, speed, scalability, and security — so you can confidently deliver a seamless digital experience.
WordPress on Azure App Service is a fully managed PaaS offering that takes care of infrastructure maintenance, security patching, and scaling for you as described here. It also supports virtual networks and can run in an isolated, dedicated App Service Environment. Features like automatic WordPress updates, threat detection, and free SSL encryption are included to enhance security for all our customers.
While there are multiple WordPress options on Azure, we recommend starting with WordPress on Azure App Service from the Azure Marketplace. This Marketplace offering is optimized for Linux App Service, making it easy to install. This comes with the latest software packages, tailored SKU sizes for both Azure App Service and Azure Database for MySQL Flexible Server, and include dedicated support from the App Service team.
🧠 Concepts
Key Features:
-
🛡️ Automatic security patches: Updates are applied within 45 days, following the support policy, to keep your WordPress site secure.
-
🚀 Pre-configured Azure CDN and Blob Storage: Optimized for content delivery, ensuring high availability and performance across the globe.
-
🏗️ Best practices from Azure Well-Architected Framework: The default setup follows Azure's best practices for security, scalability, and performance.
-
📈 Flexible hosting plans: Ranges from small hobby projects to large enterprise needs, offering scalability and customization.
-
🔄 Built-in infrastructure maintenance: Automatic updates and security patches without manual intervention.
-
📊 Automatic scaling: Resources dynamically adjust based on traffic, ensuring seamless user experiences.
-
🔒 SSL Certificates: Free SSL certificates for traffic encryption to secure your website.
-
🔗 Virtual Networks: Support for secure, isolated environments to enhance your site's security and performance.
-
🌍 Multi-cloud Availability: Available in public cloud, US Government Cloud (Fairfax), and China Cloud (Mooncake).
High-level architecture
🚀 Quickstart
1. Deploy WordPress
You can deploy the recommended version of WordPress on Azure App Service directly from the Azure Marketplace. It’s optimized for Linux App Service and pre-configured with recommended software packages, including support for Azure Database for MySQL Flexible Server.
or follow the steps outlined in the ARM template deployment guide found here .
2. Choose an Docker Image
Select from the following WordPress container images:
| Image Name | Image Stack Version | OS | PHP Version | Comments |
|---|---|---|---|---|
| mcr.microsoft.com/appsvc/wordpress-debian-php | 8.3 | Debian bookworm | 8.3 | ✅ Supported and recommended |
| mcr.microsoft.com/appsvc/wordpress-debian-php | 8.2 | Debian bullseye | 8.2 | ✅ Supported |
| mcr.microsoft.com/appsvc/wordpress-alpine-php | 8.3 | Alpine Linux 3 | 8.3 | ⚠️ Supported (End of support Dec'24) but recommended to migrate to Debian based image |
| mcr.microsoft.com/appsvc/wordpress-alpine-php | 8.2 | Alpine Linux 3 | 8.2 | ⚠️ Supported (End of support Dec'24) but recommended to migrate to Debian based image |
| mcr.microsoft.com/appsvc/wordpress-alpine-php | 8.0 | Alpine Linux 3 | 8.0 | ⚠️ End of Life |
| mcr.microsoft.com/appsvc/wordpress-alpine-php | latest | Alpine Linux 3 | 8.0 | ❌ Deprecated (Use a specific numerical tag instead) |
Note: The
latesttag points to PHP 8.0, which is no longer maintained. Always use a specific version number to avoid issues.
- Image Server URL: https://mcr.microsoft.com
- URL to view all the list of WordPress Docker Image tags here
👉 Follow this quick-start tutorial for step-by-step instructions.
📚 Tutorials
🔐 Security & Identity Management
- Change MySQL Database Password for WordPress on Linux App Service
- Change WordPress Admin Credentials for WordPress hosted on Linux App Service
- Enabling Managed Identity with Azure Communication Service Email
- Enabling Managed Identity with Azure MySQL for WordPress App Service
⚙️ Configuration & Customization
- A View of Application Settings for WordPress on Linux App Service
- Configuring Nginx for WordPress on Linux App Service
- Adding PHP Extensions for WordPress on Linux App Service
- How to Enable PHP Intl Extension with WordPress App Service
- Setup Startup Scripts for WordPress on Linux App Service
- Enabling Multi-site WordPress on Azure App Service
- How to Use WP-CLI with WordPress on App Service
- Enable Microphone and Camera with WordPress App Service
- How to use specific container image for WordPress
🔄 Migration & Database Management
- Migrate Any WordPress Site to WordPress on Linux App Service
- Configure WordPress on Linux App Service with Existing MySQL Database
- Migrate WordPress Images from Other Containers to Microsoft-Supported Containers
- Connect to Database with phpMyAdmin on WordPress App Service
🚀 Performance Optimization & Scaling
- Enabling High Performance with Local Storage
- Image Optimizations in WordPress
- Configuring Local Redis Cache for WordPress
- Hosting Plans and Scaling WordPress
- How to Enable WebP Support in WordPress on Azure App Service
🌐 Integration & Networking
- AFD Integration with WordPress on Azure App Service
- Configuring Azure Blob Storage with WordPress
- Configuring Azure CDN with WordPress
- Integrating Azure Communication Email Service with WordPress App Service
🔧 Troubleshooting & Debugging
- How to Enable Debug Logs for WordPress on App Service
- Troubleshooting CORS Errors with Azure CDN / FrontDoor or Azure Blob Storage
- Troubleshooting Guide: Existing WordPress Site Detected Warning
🎯 Development & CI/CD
- How to Create a Staging Environment for WordPress on Azure App Service
- Enabling CI/CD for WordPress on App Service
🤖 AI & Automation
🌐 Community and Support
- Check out our support documentation and engage with the Azure Support or open-source community for assistance.
- Stay updated with the latest news and features through our blog posts.
🤝 Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
⚠️ Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.