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.

Important

After November 28, 2022, PHP will only be supported on App Service on Linux..

Additional documentation, including Migrating to App Service, can be found at WordPress - App Service on Linux.

Create WordPress site using Azure portal

  1. To start creating the WordPress site, browse to https://portal.azure.com/#create/WordPress.WordPress.

    Screenshot of Create a WordPress site.

  2. In the Basics tab, under Project details, make sure the correct subscription is selected and then choose to Create new resource group. Type myResourceGroup for the name and select a Region you want to serve your app from.

    Screenshot of WordPress project details.

  3. 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.

    Screenshot of WordPress instance details.

  4. Under WordPress Settings, type an Admin Email, Admin Username, and Admin Password. The Admin Email here is used for WordPress administrative sign-in only.

    Screenshot of WordPress settings.

  5. 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.

    Screenshot of WordPress Advanced Settings.

  6. Select the Review + create tab. After validation runs, select the Create button at the bottom of the page to create the WordPress site.

    Screenshot of WordPress create button.

  7. 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.

    Screenshot of WordPress site.

  8. To access the WordPress Admin page, browse to /wp-admin and use the credentials you created in the WordPress settings step.

    Screenshot of WordPress admin login.

Note

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.

  1. From your App Service overview page, click the resource group you created in the Create WordPress site using Azure portal step.

    Resource group in App Service overview page.

  2. From the resource group page, select Delete resource group. Confirm the name of the resource group to finish deleting the resources.

    Delete resource group.

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://<sitename>.azurewebsites.net/phpmyadmin
    • Login with the flexible server's username and password
  • 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.

Next steps

Congratulations, you've successfully completed this quickstart!