Gemini said WSLStack | One-Command Laravel Environment for WSL2
WSLStack
Built for WSL2 • Debian & Ubuntu

Laravel environment
set up in seconds.

A curated, open-source script to bootstrap your WSL2 environment. Get PHP 8.4, Composer, Node.js LTS, and MySQL configured with a single command.

View on GitHub
100% Open Source
MIT Licensed
Laravel Optimized
wsl-bash — 80x24
➜ ~ bash <(curl -fsSL wslstack.sh)
[info] Detecting WSL2 Environment...
✔ Distro: Ubuntu 24.04 detected
✔ Updating system packages...
✔ Installing PHP 8.4 & Extensions...
✔ Installing Composer v2.9.5...
✔ Installing Node.js v24.14.0...
✔ Installing Nginx v1.28.2...
✔ Installing Redis Open Source 8.6...
✔ Installing MySQL 8.4 & phpMyAdmin...
Stack ready! Access your dev environment:
• Nginx: Running
• Redis: Port 6379
• MySQL: Port 3306
• phpMyAdmin: Port 8080

Stop fighting your environment.

Setting up a consistent Laravel environment on WSL2 shouldn't take all morning. We've solved the common friction points.

Native MySQL Mess

Installing MySQL natively on WSL often leads to socket errors and permission nightmares.

Version Drifts

Different machines having slightly different PHP extensions or Node versions causes "but it works for me."

Manual Drudgery

Copy-pasting 20 commands from a blog post every time you reset your WSL distro is a waste of time.

Beginner Fragility

New developers often break system-level configs. WSLStack provides a clean, repeatable baseline.

Everything you need, configured.

We don't just install packages; we tune them for Laravel development performance and security.

V1.2.0 - STABLE RELEASE

One-Command Setup

Run the script, grab a coffee, and return to a fully functional Laravel-ready Linux environment.

MySQL Database

Isolate your database. We set up MySQL 8.4 in a lightweight container with persistent volumes and phpMyAdmin.

Version Control

Easily swap between PHP 8.4 and 8.5. We handle the update-alternatives and Nginx socket configurations.

100% Open Source

No black boxes. Inspect every line of the shell script before running. Fork it, tweak it, own it.

Nginx Optimized

Pre-configured Nginx server blocks tailored for Laravel's public directory and friendly URLs.

Environment Sync

A standardized dev environment makes onboarding team members as simple as sharing a link.

The Modern Stack

Curated versions selected for stability, performance, and long-term support.

PHP
Language
v8.4 / v8.5 FPM
JS
Node.js
v24.14.0 LTS
DB
MySQL
v8.4.8 LTS
RS
Redis Open Source
v8.6 APT
NX
Server
Nginx Stable
CO
Composer
v2.9.5
PA
Interface
phpMyAdmin
W2
Platform
WSL 2

Three steps to coding.

1

Choose Preset

Select your preferred PHP version and database options from our documentation.

2

Copy Command

One string of text is all it takes to trigger the automated installation pipeline.

3

Paste & Run

Open your WSL terminal, paste, and enter. Sit back while we build your stack.

Trust matters in your infrastructure.

Running random scripts as sudo is dangerous. That's why WSLStack is built with absolute transparency. Every line of our installer is readable, versioned on GitHub, and community-audited.

  • Publicly auditable Bash scripts
  • No hidden telemetry or tracking
  • Community-driven updates and fixes
Explore the source code

Security First

Verified & Secure Shell scripts

"I used to spend hours fixing my MySQL sockets on WSL every time there was a Windows update. WSLStack's Docker-first approach fixed that once and for all."

Laravel Developer @ CAVRELY — Web TROUBLESHOOTING PARTNER
installation_preview.sh
# Start your installation
$ bash <(curl -fsSL [https://wslstack.pages.dev/install.sh](https://wslstack.pages.dev/install.sh))
[1/6] Validating WSL2 Distribution... Done.
[2/6] Configuring PPA repositories... Done.
[3/6] Installing PHP 8.4-fpm, cli, mysql, redis, xml, zip... Done.
[4/6] Bootstrapping Docker environment... Done.
[5/6] Spinning up MySQL & Redis containers... Done.
[6/6] Linking Nginx to Laravel projects directory... Done.
WSLStack has been successfully installed!
Log out and log back in to apply group changes.

Frequently Asked Questions

No. WSLStack is strictly designed for local development on WSL2. It prioritizes developer convenience and debugging tools which are not suitable for a production environment.
We officially support the latest LTS versions of Ubuntu (22.04, 24.04) and Debian stable. Other Debian-based distros may work but aren't explicitly tested.
By default, we recommend and set up MySQL. However, the script provides an option to install it natively if you have Docker constraints.
Native MySQL on WSL2 often suffers from permission issues between Windows and Linux file systems. Running it in a container bypasses these hurdles and allows for easy version switching.
Absolutely. We encourage it. You can visit the URL in the install command directly in your browser or view the full source on our GitHub repository.
Yes, WSLStack is licensed under MIT. You can use it, modify it, and distribute it freely for both personal and commercial development workflows.

Ready to build?

Join hundreds of developers who have simplified their WSL2 workflow.

bash <(curl -fsSL wslstack.sh)
View Source Read Docs