How to setup LAMP on WSL

Nathan Henniges
October 16, 2018

Building Web Apps on windows has changed a lot in the last 4 years.  Now you can run a full Ubuntu command line on top of your windows 10 install.  It does have a few issues, but they are being fixed in every update.  And by far it works very well for being in development still.  It supports around 99% of Linux packages I would say.

Want to get started today building your LAMP app or using WordPress today?  Lets get started.

Before we start make sure you: 

  1. 64-bit version of Windows 10 with the Creators Update or later. 
  2. familiarity with Linux/bash (If you would like to get familiar with the command-line, you can read this DigitalOcean tutorial).

Step 1 (Enable Windows Subsystem for Linux) 

We need to enable the Windows Subsystem for Linux in Windows 10 

  1. Go to search and type in “Turn Windows features on or off” 
  2. Find Windows Subsystem for Linux 

Enable WSL feature.

Once you enable it you must go to the Microsoft Store and type WSL and click Get the App on the “Linux on Windows?”

WSL Store Page

Now time to pick your distro 

Supported distros are Ubuntu (16.04 and 18.04 LTS), Kail Linux, Debian, openSUSE Leap 42, and SUSE Linux Enterprise Server 12. 

Once it’s installed you can now launch it and create your Unix user.  If you need any more help you can always read Microsoft great how-to setup here

Step 2 (Install Apache2) 

We want to get the latest apache2 stable build from Offical ubuntu repositories. 

Lets update packages so we have the lastest.  

$ sudo apt update

$ sudo apt upgrade

Install Apache

$ sudo apt install apache2 -y  

*-y accepts all new packages installed. 

Now we must create projects folder outside WSL  

This command will create the folder in your documents folder. Please replace YOUR WINDOWS USERNAME with your Windows username. 

$ sudo mkdir /mnt/c/Users/YOUR WINDOWS USERNAME/Documents/www

Create a symbolic link to the selected folder. 

$ sudo ln -s /mnt/c/Users/YOUR WINDOWS USERNAME/Documents/www /var/www/public

Open the Apache default configuration 

$ sudo nano /etc/apache2/apache2.conf 

Find the line with “<Directory /var/www/>” and replace where it says “AllowOverride” with “AllowOverride all”

Open the apache2 default site config 

$ sudo nano /etc/apache2/sites-enabled/000-default.conf

Change DocumentRoot  to /var/www/public 

And ServerName to localhost 

Open your favorite editor and create a index.html in your project folder((C:\\Users\\ YOUR WINDOWS USERNAME\\Documents\\server) the following html

<!DOCTYPE html>
<html lang="en">
<meta charset="utf-8">
<title>It works!</title>
<h1>It works!</h1>

Start Apache2 

$ sudo service apache2 start 

You should be able to go to localhost in your browser

Note my WSL is fully customized.

WordPress needs apache rewrite enabled. 

$ sudo a2enmod rewrite

$ sudo service apache2 restart

Now we have working apache2 install.  If this is all you need then your fine.  But if you want PHP and MySQL. 

Part 3 (Installing MySQL Database)

We want to get the latest mysql-server stable build from Offical ubuntu repositories.

$ sudo apt install mysql-server -y

*-y accepts all new packages installed

Now let’s start the database server

$ sudo service mysql start

Let’s make the MySQL database server more secure. They made this easy by running one command.

$ sudo mysql_seure_installation

For managing MySQL Server, would recommend heidisql which you can download here 

Step 4 (Install PHP) 

We want to get the latest php sable build from Offical ubuntu repositories. 

$ sudo apt install libapache2-mod-php7.2 php7.2-mcrypt php7.2-mysql php7.2-mbstring php7.2-gettext php7.2-xml php7.2-json php7.2-curl php7.2-zip -y 

*-y accepts all new packages installed. 

We will have to restart apache2 

$ sudo service apache2 restart

Now just like before when we created the index.html.  We will create another file called info.php in the same folder. Paste the following PHP code to see if PHP is working.


Open localhost/info.php 

You should see:

Using PHP-FPM here as I am using HTTP2. 

There will be a blog post coming soon about how to enable that.


WSL does not replace docker or a VM 100% but it’s a great start to development on windows being much easier and faster.  All Microsoft has to do is keep making improvements and upgrading WSL soon would be the day everyone uses windows 10 to develop your web apps with the help of WSL.

Comment below what you think about Windows Subsystem for Linux.  Make sure to follow us on Twitter to be notified of our upcoming posts.