Create a WordPress site
WordPress is an open source content management system (CMS) used by over 40% of the web to create websites, blogs, and other applications. WordPress can be run on a few different Azure services: AKS, Virtual Machines, and App Service. For a full list of WordPress options on Azure, see WordPress on Azure Marketplace.
In this quickstart, you'll learn how to create and deploy your first WordPress site to Azure App Service on Linux with Azure Database for MySQL - Flexible Server using the WordPress Azure Marketplace item by App Service. This quickstart uses the Basic tier for your app and a Burstable, B1ms tier for your database, and incurs a cost for your Azure Subscription. For pricing, visit App Service pricing and Azure Database for MySQL pricing.
To complete this quickstart, you need an Azure account with an active subscription. Create an account for free.
After November 28, 2022, PHP will only be supported on App Service on Linux..
Create WordPress site using Azure portal
To start creating the WordPress site, browse to https://portal.azure.com/#create/WordPress.WordPress.
In the Basics tab, under Project details, make sure the correct subscription is selected and then choose to Create new resource group. Type
myResourceGroupfor the name and select a Region you want to serve your app from.
Under Hosting details, type a globally unique name for your web app and choose Linux for Operating System. Select Basic for Hosting plan. Select Compare plans to view features and price comparisons.
Select the Advanced tab. Under Additional Settings choose your preferred Site Language and Content Distribution. If you're unfamiliar with a Content Delivery Network or Blob Storage, select Disabled. For more details on the Content Distribution options, see WordPress on App Service.
Select the Review + create tab. After validation runs, select the Create button at the bottom of the page to create the WordPress site.
Browse to your site URL and verify the app is running properly. The site may take a few minutes to load. If you receive an error, allow a few more minutes then refresh the browser.
To access the WordPress Admin page, browse to
/wp-adminand use the credentials you created in the WordPress settings step.
If you have feedback to improve this WordPress offering on App Service, submit your ideas at Web Apps Community.
Clean up resources
When no longer needed, you can delete the resource group, App service, and all related resources.
From your App Service overview page, click the resource group you created in the Create WordPress site using Azure portal step.
From the resource group page, select Delete resource group. Confirm the name of the resource group to finish deleting the resources.
Manage the MySQL flexible server, username, or password
The MySQL Flexible Server is created behind a private Virtual Network and can't be accessed directly. To access or manage the database, use phpMyAdmin that's deployed with the WordPress site. You can access phpMyAdmin by following these steps:
- Navigate to the URL: https://
- Login with the flexible server's username and password
- Navigate to the URL: https://
Database username and password of the MySQL Flexible Server are generated automatically. To retrieve these values after the deployment go to Application Settings section of the Configuration page in Azure App Service. The WordPress configuration is modified to use these Application Settings to connect to the MySQL database.
To change the MySQL database password, see Reset admin password. Whenever the MySQL database credentials are changed, the Application Settings need to be updated. The Application Settings for MySQL database begin with the
DATABASE_prefix. For more information on updating MySQL passwords, see WordPress on App Service.
Change WordPress admin password
The Application Settings for WordPress admin credentials are only for deployment purposes. Modifying these values has no effect on the WordPress installation. To change the WordPress admin password, see resetting your password. The Application Settings for WordPress admin credentials begin with the
WORDPRESS_ADMIN_ prefix. For more information on updating the WordPress admin password, see Changing WordPress Admin Credentials.
Migrate to App Service on Linux
There's a couple approaches when migrating your WordPress app to App Service on Linux. You could use a WP plugin or migrate manually using FTP and a MySQL client. Additional documentation, including Migrating to App Service, can be found at WordPress - App Service on Linux.
Congratulations, you've successfully completed this quickstart!
Submit and view feedback for