How to Install WordPress with WSL on Windows 11 for Easy Development

Setting up WordPress on Windows 11 using Windows Subsystem for Linux (WSL) offers a powerful, lightweight environment for local development, testing, and learning. This approach allows you to run a Linux-based server directly on your Windows machine without the need for dual-booting or dedicated hosting. Whether you’re a developer, student, or hobbyist, installing WordPress via WSL provides a seamless way to work with WordPress in a controlled environment. Before starting, ensure your Windows 11 system is up to date, and you have administrator rights to install necessary components.

What You’ll Need

• Windows 11 PC with administrator rights
• Internet connection for downloading updates and software
• Basic familiarity with command-line interface (CLI)
• Optional: a text editor like Visual Studio Code or Notepad++ for editing files

Step-by-Step

1. Enable WSL and Virtual Machine Platform: Open PowerShell as Administrator and run:

    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   

   After executing, restart your computer to apply changes.

2. Install WSL 2: Download the WSL 2 Linux kernel update package from the official Microsoft website and run the installer. Then, set WSL 2 as your default version by running:

    wsl --set-default-version 2

3. Install a Linux Distribution: Open the Microsoft Store, search for Ubuntu (preferably Ubuntu 22.04 LTS), and click Install. Once installed, launch Ubuntu from the Start menu and set up your username and password.
4. Update Ubuntu Packages: Inside the Ubuntu terminal, run:

    sudo apt update && sudo apt upgrade -y

5. Install Apache, MySQL, PHP (LAMP stack): Run the following commands:

    sudo apt install apache2 mysql-server php libapache2-mod-php php-mysql -y

   Ensure Apache and MySQL are running:

    sudo service apache2 start
    sudo service mysql start

6. Configure MySQL: Secure your MySQL installation:

    sudo mysql_secure_installation

   Follow prompts to set root password and secure your database.

7. Install WordPress: Download WordPress from the official site:

    wget https://wordpress.org/latest.tar.gz
    tar -xzf latest.tar.gz
    sudo mv wordpress /var/www/html/wordpress

   Set permissions:

    sudo chown -R www-data:www-data /var/www/html/wordpress
    sudo chmod -R 755 /var/www/html/wordpress

8. Configure Apache Virtual Host: Create a new config file:

    sudo nano /etc/apache2/sites-available/wordpress.conf

   Add the following:

    
    ServerAdmin admin@localhost
    ServerName localhost
    DocumentRoot /var/www/html/wordpress
    
    AllowOverride All
    Require all granted
    
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
   

   Enable the site and rewrite module:

    sudo a2ensite wordpress.conf
    sudo a2enmod rewrite
    sudo systemctl restart apache2

9. Complete WordPress Installation: Open your browser and navigate to http://localhost/wordpress. Follow the on-screen instructions to connect to your database and finalize the setup.

Common Mistakes

• Forgetting to restart Windows after enabling WSL features, which prevents installation from completing properly.
• Not setting WSL 2 as default, leading to compatibility issues with Linux kernel updates.
• Misconfiguring permissions on WordPress files, resulting in errors or security issues.
• Skipping database security setup, leaving your local database vulnerable.
• Not updating the Linux packages before installing new software, which can cause conflicts or outdated dependencies.

Tips

• Use a dedicated folder for your WordPress installation to keep files organized.
• Regularly update your Linux packages and WordPress for security and performance improvements.
• Use a text editor like Visual Studio Code with the Remote – WSL extension for easier editing and debugging.
• Backup your WordPress files and database periodically, even on local setups.
• Consider installing phpMyAdmin for easier database management via a web interface.

Troubleshooting

If you encounter issues during installation or setup, try these steps:

• WSL not starting or errors in Linux terminal: Ensure WSL 2 is installed and set as default. Run wsl --list --verbose to check version. If needed, set your distribution to version 2 with wsl --set-version Ubuntu 2.
• Apache server not responding: Check Apache status with sudo service apache2 status. Restart it if necessary. Also, verify your firewall settings allow HTTP traffic.
• Database connection errors: Confirm your database credentials are correct in wp-config.php. Make sure MySQL service is running.
• Permissions errors on WordPress files: Run sudo chown -R www-data:www-data /var/www/html/wordpress and ensure proper directory permissions.
• Browser cannot access localhost: Confirm your WSL IP address matches localhost or try accessing via localhost or your WSL IP.

Frequently Asked Questions

1. Can I run WordPress directly on Windows without WSL?

Yes, but WSL provides a more authentic Linux environment, which is closer to production servers and ideal for development.

2. Is WSL 2 necessary for this setup?

Yes, WSL 2 offers better performance and full Linux kernel support, making it the recommended choice for hosting server environments like WordPress.

3. Do I need to install PHPMyAdmin separately?

Yes, PHPMyAdmin is not included by default. You can install it on your Linux environment for easier database management if desired.

4. How do I update WordPress later?

Download the latest version from the WordPress site, replace the existing files in your WordPress directory, and run the update script via your browser.

5. Can I run multiple WordPress sites on this setup?

Yes, by creating separate directories and virtual host configurations for each site, you can host multiple WordPress instances locally.

6. Is this setup suitable for production?

This setup is ideal for development and testing. For production, consider deploying on a dedicated Linux server or cloud hosting platform.

By following these detailed steps, you can efficiently set up WordPress on Windows 11 using WSL, giving you a powerful local development environment that closely mimics a live server. This approach enhances your workflow, reduces dependency on external hosting, and allows for easy experimentation and learning.

Related

• Complete List of Gojira Band Members
• Complete List of Gojira Band Members
• Complete List of Sabaton Band Members