Performance on Windows
Depending on your setup, you may experience performance issues when using magicLAMP on Windows.
This is usually caused by mounting your
PROJECTS_DIR from your Windows host instead of through
the Linux VM that is included in WSL2.
To resolve this issue, you need to keep your projects directory inside of WSL2 and not on your host system.
Storing projects in WSL2
After following this guide, all
must be run inside of Ubuntu 20.04.
This is to ensure your projects directory is correctly mounted.
- WSL2 installed and enabled in Docker Desktop
- WSL2 version of Ubuntu 20.04 installed from Microsoft Store
Creating the projects directory
Open "Ubuntu 20.04" from the start menu in Windows. This will give you a bash shell inside of Ubuntu 20.04.
Once you're in here, run the following commands.
sudo mkdir /projects
sudo chown -R 1000:1000 /projects
Accessing Linux files in Windows
You can access the files in your WSL2 distro using the Windows File Explorer.
Depending on how up-to-date your version of Windows is, these will either show up
under a "Linux" heading in the sidebar, or you can get to them manually by typing
\\wsl$ in the file path of Windows Explorer.
Once you can see the network shares, you will need to enter the Ubuntu-20.04 share to
access the filesystem of Ubuntu 20.04. In here, you should see the
projects folder you
If you already have your project files stored in a previous location, you can copy them into this folder.
You now need to update your
.env file to point
PROJECTS_DIR to your projects
folder that is now stored in WSL2.
Based on the previous step, your projects will now be stored in
/projects, so update
PROJECTS_DIR variable in
.env to match.
You now need to restart magicLAMP for these changes to take effect.
You must now run all
docker-compose commands inside of Ubuntu 20.04.
cd into the path where you installed magicLAMP. Windows drives can be found in
docker-compose up -d
Working on projects stored in WSL2
Now that your projects are stored inside WSL2, you will need to work on these from the WSL2 network share.
You should be able to import your projects from this network share into your preferred IDE.