Setting Up Local WP on a WSL2/Ubuntu Environment

Workflow
, ,
1

Hello all! I really love Local WP and its seamless integration with WP Engine. I wanted to get it working with my WSL2/Ubuntu environment, but I had a tough time figuring it out. While I was able to find bits and pieces of information by searching through forums, I wanted to share my experience on how I successfully set up my environment in 2025. Hopefully, this will help someone else in the future.

Link to article: https://medium.com/@echernicky/setting-up-a-local-wp-wsl-ubuntu-environment-9e7bdc6e9dbd

Please let me know if you have comments or questions!

2 Likes
2

Thank you for this write-up @commonllama! This is definitely something that’s been on our minds that we look to improve in the future! Your article should be very useful in the meantime for users running into trouble. :green_heart:

1 Like
4

THANK U SO MUCH!! I was pulling my hair out!

Just wanted to add that this guide got me most of the way there - but turns out I was missing one final package: libgbm-dev which I installed by using sudo apt-get install -y libgbm-dev

I also found buried in another thread that using sudo local --no-sandbox is a good way to debug what packages are missing.

1 Like
5

Thank you for sharing @denisenadal! :green_heart:

6

Thank you for the update @denisenadal! Glad it mostly worked for you. Just updated the doc with the package you were missing. Appreciate the feedback!

1 Like