# Setting Up Local WP on a WSL2/Ubuntu Environment

**URL:** <https://community.localwp.com/t/setting-up-local-wp-on-a-wsl2-ubuntu-environment/46578>\
**Category:** Workflow\
**Tags:** linux-ubuntu, ubuntu, wsl2\
**Created:** [January 20, 2025, 4:50pm UTC](https://community.localwp.com/t/setting-up-local-wp-on-a-wsl2-ubuntu-environment/46578 "2025-01-20T16:50:23Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![commonllama](https://sea1.discourse-cdn.com/flex019/user_avatar/community.localwp.com/commonllama/32/23599_2.png) [@commonllama](https://community.localwp.com/u/commonllama)\
**Post date:** [January 20, 2025, 4:50pm UTC](https://community.localwp.com/t/setting-up-local-wp-on-a-wsl2-ubuntu-environment/46578/1 "2025-01-20T16:50:23Z")

</div>

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](https://medium.com/@echernicky/setting-up-a-local-wp-wsl-ubuntu-environment-9e7bdc6e9dbd)

Please let me know if you have comments or questions!

---

<div class="post-metadata">

**Author:** ![Nick-B](https://sea1.discourse-cdn.com/flex019/user_avatar/community.localwp.com/nick-b/32/16140_2.png) [@Nick-B](https://community.localwp.com/u/Nick-B)\
**Post date:** [January 20, 2025, 6:40pm UTC](https://community.localwp.com/t/setting-up-local-wp-on-a-wsl2-ubuntu-environment/46578/2 "2025-01-20T18:40:59Z")

</div>

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. 💚

---

<div class="post-metadata">

**Author:** ![denisenadal](https://avatars.discourse-cdn.com/v4/letter/d/7cd45c/32.png) [@denisenadal](https://community.localwp.com/u/denisenadal)\
**Post date:** [April 9, 2025, 5:27pm UTC](https://community.localwp.com/t/setting-up-local-wp-on-a-wsl2-ubuntu-environment/46578/4 "2025-04-09T17:27:13Z")

</div>

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.

---

<div class="post-metadata">

**Author:** ![Nick-B](https://sea1.discourse-cdn.com/flex019/user_avatar/community.localwp.com/nick-b/32/16140_2.png) [@Nick-B](https://community.localwp.com/u/Nick-B)\
**Post date:** [April 10, 2025, 1:29pm UTC](https://community.localwp.com/t/setting-up-local-wp-on-a-wsl2-ubuntu-environment/46578/5 "2025-04-10T13:29:32Z")

</div>

Thank you for sharing @denisenadal! 💚

---

<div class="post-metadata">

**Author:** ![commonllama](https://sea1.discourse-cdn.com/flex019/user_avatar/community.localwp.com/commonllama/32/23599_2.png) [@commonllama](https://community.localwp.com/u/commonllama)\
**Post date:** [May 16, 2025, 5:26pm UTC](https://community.localwp.com/t/setting-up-local-wp-on-a-wsl2-ubuntu-environment/46578/6 "2025-05-16T17:26:11Z")

</div>

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!