How to Install the LAMP Stack on Windows WSL

If you’re a developer or hobbyist looking to run a Linux-based server environment on your Windows machine, installing the LAMP stack (Linux, Apache, MySQL/MariaDB, PHP) via Windows Subsystem for Linux (WSL) is an efficient solution. This setup allows you to develop, test, and deploy web applications locally without needing a separate Linux machine or virtual machine. Before you start, ensure you’ve installed WSL on your Windows system, preferably WSL 2 for better performance and compatibility. This guide walks you through the entire process of installing and configuring the LAMP stack on Windows WSL, step-by-step.

What You’ll Need

• Windows 10 or Windows 11 with WSL installed and enabled
• WSL 2 installed and set as default
• A Linux distribution installed via Microsoft Store (Ubuntu recommended)
• Basic familiarity with command-line operations
• Internet connection for downloading packages

Step-by-Step

1. Enable WSL and Install a Linux Distribution
• Open PowerShell as Administrator and run: wsl --install to install WSL 2 and the default Linux distribution (Ubuntu recommended). If WSL is already installed, ensure you’re on WSL 2 by running: wsl --set-default-version 2.
• Once installed, open the Microsoft Store, search for Ubuntu (or your preferred Linux distro), and install it.
• Launch Ubuntu from the Start menu and complete the initial setup, including creating a username and password.
2. Update Package Lists and Upgrade Packages
• In your Linux terminal, run: sudo apt update && sudo apt upgrade -y to ensure all packages are current.
3. Install Apache Web Server
• Run: sudo apt install apache2 -y
• Start Apache with: sudo service apache2 start
• Verify installation by opening a web browser and navigating to http://localhost. You should see the Apache default page.
4. Install MySQL or MariaDB Database Server
• For MySQL: sudo apt install mysql-server -y
• For MariaDB (a drop-in replacement): sudo apt install mariadb-server -y
• Secure your database server by running: sudo mysql_secure_installation. Follow the prompts to set root passwords and remove insecure defaults.
5. Install PHP and Modules
• Run: sudo apt install php libapache2-mod-php php-mysql -y
• Restart Apache to enable PHP: sudo service apache2 restart
6. Test PHP Processing
• Create a PHP info file: sudo nano /var/www/html/info.php
• Add the following line:

  <?php phpinfo(); ?>

• Save and exit (Ctrl+X, then Y, then Enter). Visit http://localhost/info.php to see PHP information page.
7. Configure Firewall and Permissions
• Ensure that port 80 is accessible. WSL typically forwards ports, but if necessary, adjust Windows Firewall settings.
• Set appropriate permissions for your web directory if needed.

Common Mistakes

• Skipping the WSL 2 upgrade—using WSL 1 can cause performance issues and compatibility problems.
• Not updating packages before installation, leading to outdated or missing dependencies.
• Forgetting to restart Apache after PHP installation, which prevents PHP from working correctly.
• Assuming localhost traffic is automatically forwarded—sometimes network settings or firewalls block access.
• Not securing your database server after installation, leaving it vulnerable.

Tips

• Use Ubuntu (or your preferred distro) for the best community support and documentation.
• Regularly update your packages to keep the stack secure and up-to-date.
• Customize your Apache configuration files for specific project needs.
• Set up virtual hosts to manage multiple projects easily.
• Consider installing phpMyAdmin or other tools for easier database management.
• Back up your databases and configuration files regularly.

Troubleshooting

If something isn’t working as expected, here are common issues and solutions:

• Apache won’t start or serve pages: Check the status with sudo service apache2 status. Ensure no other service is occupying port 80. Restart WSL with wsl --shutdown and relaunch Ubuntu.
• PHP info page not displaying correctly: Confirm PHP module installation with php -v. Restart Apache after installing PHP modules.
• Database server not responding: Check if the service is active with sudo service mysql status. Review error logs in /var/log/mysql/error.log.
• Network issues accessing localhost: Verify WSL network forwarding settings. Sometimes restarting WSL or Windows helps.
• Permissions errors: Ensure your web files have the correct permissions, e.g., sudo chown -R www-data:www-data /var/www/html.

Frequently Asked Questions

Can I run the LAMP stack entirely within Windows without WSL?

No, WSL provides a Linux environment needed for the stack. Alternatives include virtual machines or Docker.

Is WSL 2 necessary for installing the LAMP stack?

While WSL 1 can work, WSL 2 offers better compatibility, performance, and full Linux kernel support, making it highly recommended.

How do I access my web server from other devices on my network?

You need to configure Windows firewall and WSL network forwarding, and possibly set static IP addresses or port forwarding rules.

Can I install other PHP modules or software later?

Yes, use apt install to add more PHP modules or software packages as needed.

How do I upgrade my Linux distribution inside WSL?

Run sudo apt update && sudo apt upgrade regularly. For distribution upgrades, follow the specific distro’s upgrade instructions.

Is it safe to run a public-facing server on WSL?

It’s suitable for development and testing, but for production, consider dedicated servers or cloud hosting for security and stability.

This comprehensive guide helps you set up a powerful local web development environment with WSL, enabling you to build and test web apps efficiently on Windows. Follow each step carefully, and you’ll have your LAMP stack ready for your projects in no time.

Related

• How to Hide the Account Protection Section in the Windows Security Apps on Windows 11
• How to Hide Taskbar in Windows 11 for a Cleaner Desktop
• How to Hide Taskbar Windows 10 Simple Steps to Tidy Your Desktop