LAMP Development Using Windows Subsystem for Linux (WSL)

James McDonald — Sun, 15 Jun 2025 19:12:11 +0000

WSL provides a convenient Linux file system that runs alongside Windows. Command-line tools and apps are then available across file systems. This allows you to avoid the pitfalls of dual-booting or running a more resource-intensive virtual machine.

Considering these benefits, let's set up a development environment for the LAMP stack (Linux, Apache, MySQL, and PHP)!

In this article, we cover these topics:

Set up Windows Subsystem for Linux (WSL)
Set up Apache
Set up PHP
Set up MySQL
Put it all together

😕 TL&DR;
I understand if you're not interested. Feel free to skip the heavy reading and run the automation script I created!

1️⃣ Set up Windows Subsystem for Linux (WSL)

By default, WSL is not enabled on Windows 10 or Windows 11. Without it, we don't have Linux.

Install WSL

Open Command Prompt (cmd.exe) or PowerShell (pwsh.exe) and install the default distribution. Windows will ask for permission to run this command (choose Yes). Enter your desired credentials when prompted. After the Ubuntu shell appears, keep it open to continue.

wsl --install

Update the installed packages.

Pre-installed packages for any Linux distribution are not consistently up-to-date. On your first run, update before doing anything else. With Ubuntu (24.04 as of writing), the built-in package manager is apt. While using the sudo command (usually for the first time in a session), enter your password when prompted.

sudo apt update && sudo apt upgrade -y

2️⃣ Set up Apache

Install and enable Apache.

Apache is an HTTP server—it responds to web requests. We need it to get started. After running these commands, press CTRL+C to return to the Ubuntu shell.

sudo apt install apache2 -y && 
sudo systemctl status apache2

Test the web server.

Apache creates a template home page that you can view in the browser or even with the curl command.

curl localhost

Create a new default directory.

Instead of reconfiguring the default content in the html directory, create a new root directory (public_html) to serve from. Ensure that the new directory has specific ownership and permissions. Validate success by checking the contents of the /var/www/ directory.

sudo mkdir -m 2755 /var/www/public_html/ && 
sudo chown $USER:$USER /var/www/public_html/ && 
ll /var/www/

Back up the default sites-available configuration file.

sites-available.conf is the default file that sets your root directory for Apache. Back up a copy in case you run into problems customizing it. Validate success by listing the contents of the /etc/apache2/sites-available/ directory.

sudo cp /etc/apache2/sites-available/000-default.conf \
/etc/apache2/sites-available/000-default-backup.conf && 
ll /etc/apache2/sites-available/

Remap to the new default directory.

Change the DocumentRoot to point to our newly created public-html directory.

sudo sed --in-place \
's/DocumentRoot.*\/html/DocumentRoot \/var\/www\/public_html/' \
/etc/apache2/sites-available/000-default.conf &&
grep /etc/apache2/sites-available/000-default.conf \
--regexp 'DocumentRoot.*html'

3️⃣ Set up PHP

Install and verify PHP.

PHP is a server-side scripting language that allows us to render data without burdening the client's device or exposing the code itself. Soon, we'll use it to reveal information from a MySQL service. Here, we'll install the necessary packages and confirm the version of PHP we get.

sudo apt install php libapache2-mod-php php-mysql -y &&
php --version

Test a new home page.

Add index.php to the default web directory and write the page content using phpinfo(). Test the results using curl.

sudo echo "<?php phpinfo(); ?>" > \
/var/www/public_html/index.php &&
curl localhost

4️⃣ Set up MySQL

Install and enable MySQL.

MySQL is an open-source database management system that you can use to start storing data for your website. Whether you are manipulating data using management software, the command line, or interactive web pages, the MySQL service must be running. After running these commands, press CTRL+C to return to the Ubuntu shell.

sudo apt install mysql-server -y &&
sudo systemctl status mysql

Connect to MySQL as root and create a new user.

The root user is available by default, but it's likely better to create an alternate user. You'll struggle to connect with MySQL Workbench if you don't complete this step.

⚠️ Important!
Each of these three commands must be run separately. Please don't copy and paste this entire block. Also, replace 'username' and 'password' with your Linux credentials.

sudo mysql
CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';
exit

Connect to MySQL with your new username and password.

If you make any mistakes, your new user won't get far. So, test it by logging in after running mysql -p from the bash prompt and then entering your password. When you're finished, return to the Ubuntu shell with the exit command.

5️⃣ Put it all together

To get an idea of what you've accomplished, let's modify the index.php homepage to get data from MySQL and display it.

Open index.php for editing.

First, open the file using the nano text editor.

nano /var/www/public_html/index.php

Create a PHP page that connects to a MySQL database.

Replace the current contents of the file with this code (CTRL+V works). Again, change the username and password accordingly. Then, press CTRL+S to save and CTRL+X to return to the Ubuntu shell.

<?php

printf("<h1>MySQLi Test</h1>");

$mysqli = new mysqli("localhost", "username", "password");
printf("<p>MySQLi connected <strong>successfully</strong>.</p>");
if ($mysqli->connect_errno) {
    printf("Connect failed: %s\n", $mysqli->connect_error);
    exit();
}

$result = $mysqli->query("SHOW DATABASES");
printf("<p>" . "SHOW DATABASES result set has <strong>%d rows</strong>.", $result->num_rows . "</p>");
if ($mysqli->errno) {
    printf("Query failed: %s\n", $mysqli->error);
    exit();
}

printf("<h2>Databases:</h2>");
printf("<ul>");

while ($row = $result->fetch_assoc()) {
    printf("<li>" . $row["Database"] . "</li>");
}

printf("</ul>");

$result->free();
$mysqli->close();

Verify your work.

For the grand finale, why not just open localhost in your browser? You should see output like this:

⚡ TL;DR

If you couldn't be bothered to read the article, let's do things the fast way.

Install WSL

Open Command Prompt (cmd.exe) or PowerShell (pwsh.exe) and install the default distribution. When prompted, enter your desired Linux username and password. Leave Ubuntu open after installation.

wsl --install

Auto-configure a LAMP environment

From the Ubuntu console, run this automation script, and enter credentials when prompted.

⚠️ Warning!
Running shell (.sh) scripts provided by a strange website can be a terrible idea. So that you know what I'm up to, feel free to visit the publicly available GitHub Gist file to see what is happening. Only run it if you trust it!

bash <(curl https://gist.githubusercontent.com/jmcscript/0efa75b59c21524abf0e539a067a5880/raw/09e9cb7da8756026c94157d9a92e800ffc5bf11a/wsl-setup.sh)

🏁 Conclusion

WSL provides an actual Linux-like environment for local development. There are many benefits to this approach. I hope this article helped you get up and running quickly.

Does this work for you?

Have you encountered any problems or errors with anything I've had you try? Feel free to contact me or comment on the article. Any feedback is greatly appreciated.

Use VS Code with WSL

VS Code has a WSL extension. You don't need to code in Linux directly using apt packages.

Use MySQL Workbench with WSL

MySQL Workbench is a free visual tool for working with databases. Use it to connect directly with WSL when the mysql service is running by connecting to localhost with your new user.

Use Docker Desktop with WSL

It seems containers are hot right now. Using Docker Desktop, you can develop locally using WSL and deploy to a production environment.

📖 Further Reading

Article Reference

Command Reference

sed - systemctl - mkdir - chown - cp - ll - grep - output redirect (>) - php - mysql - CREATE USER - nano

DEV Community: James McDonald

LAMP Development Using Windows Subsystem for Linux (WSL)

1️⃣ Set up Windows Subsystem for Linux (WSL)

Install WSL

Update the installed packages.

2️⃣ Set up Apache

Install and enable Apache.

Test the web server.

Create a new default directory.

Back up the default sites-available configuration file.

Remap to the new default directory.

3️⃣ Set up PHP

Install and verify PHP.

Test a new home page.

4️⃣ Set up MySQL

Install and enable MySQL.

Connect to MySQL as root and create a new user.

Connect to MySQL with your new username and password.

5️⃣ Put it all together

Open index.php for editing.

Create a PHP page that connects to a MySQL database.

Verify your work.

⚡ TL;DR

Install WSL

Auto-configure a LAMP environment

🏁 Conclusion

Does this work for you?

Use VS Code with WSL

Use MySQL Workbench with WSL

Use Docker Desktop with WSL

📖 Further Reading

Article Reference

Command Reference

Related Topics