PHPackages eptic/valet-wsl - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [DevOps & Deployment](/categories/devops) 4. / 5. eptic/valet-wsl ActiveLibrary[DevOps & Deployment](/categories/devops) eptic/valet-wsl =============== Advanced local development experience for Windows Subsystem for Linux. v2.0.1(2y ago)111801[2 PRs](https://github.com/EPTIC-Solutions/valet-wsl/pulls)MITPHPPHP ^8.1|^8.2CI passing Since Mar 22Pushed 4mo ago1 watchersCompare [ Source](https://github.com/EPTIC-Solutions/valet-wsl)[ Packagist](https://packagist.org/packages/eptic/valet-wsl)[ RSS](/packages/eptic-valet-wsl/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (8)Versions (25)Used By (0) [![](https://raw.githubusercontent.com/eptic-solutions/art/master/cover.png)](https://solutions.eptic.ro) [![Total Downloads](https://camo.githubusercontent.com/0f34df9ad82715455a4bc73fc5e127343aa1cbcf9ac50598f52b01dda9bdfbfe/68747470733a2f2f706f7365722e707567782e6f72672f65707469632f76616c65742d77736c2f646f776e6c6f6164732e737667)](https://packagist.org/packages/eptic/valet-wsl) [![Latest Stable Version](https://camo.githubusercontent.com/51ec4d9adbe340f4928d9f84af451b0c3d4452eca558535b9a8e0a3c7150bc54/68747470733a2f2f706f7365722e707567782e6f72672f65707469632f76616c65742d77736c2f762f737461626c652e737667)](https://packagist.org/packages/eptic/valet-wsl) [![Latest Unstable Version](https://camo.githubusercontent.com/f9997c1ad404e5bc2867763deffc54e115b07cc692d84bfde0b7f81d07ea2730/68747470733a2f2f706f7365722e707567782e6f72672f65707469632f76616c65742d77736c2f762f756e737461626c652e737667)](https://packagist.org/packages/eptic/valet-wsl) [![License](https://camo.githubusercontent.com/fdbdf9d28b2c779d2b990de954120f4caedfb900cd43ed7804c07009856d6e63/68747470733a2f2f706f7365722e707567782e6f72672f65707469632f76616c65742d77736c2f6c6963656e73652e737667)](https://packagist.org/packages/eptic/valet-wsl) Introduction ------------ [](#introduction) Valet *WSL* is an advanced development environment for Windows Subsystem for Linux. No Vagrant, no `hosts` file manual management. You can even share your sites publicly using local tunnels. *Yeah, we like it too.* Valet *WSL* configures your system to always run Nginx in the background when your machine starts. Because of the WSL limitations, DnsMasq is not used, instead valet manages the hosts files when any website is linked or unlinked. In other words, a blazing fast PHP development environment that uses roughly 7mb of RAM. Valet *WSL* isn't a complete replacement for Valet Linux+, Laravel Valet, Vagrant or Homestead, but provides a great alternative if you want flexible basics, prefer extreme speed, or are working on a machine with a limited amount of RAM. This is a port of [Valet Linux+](https://github.com/genesisweb/valet-linux-plus) made for WSL. If you want the DnsMasq version of this project, please check it out. Official Documentation ---------------------- [](#official-documentation) ### Installing `Valet WSL` [](#installing-valet-wsl) ### Important [](#important) - Always run Valet commands from a WSL shell runned as administrator. #### Requirements [](#requirements) Required OSWSL Ubuntu 14.04+OS Packagessudo apt-get install jq xselPHP Version7.4, 8.0, 8.1PHP Extensionsphp-cli php-curl php-mbstring php-mcrypt php-xml php-zip#### Installation [](#installation) - Install or update PHP to one of the versions mentioned in the requirements. - Install [Composer](https://getcomposer.org/) from the official website. - Install Valet WSL with Composer via `composer global require eptic/valet-wsl`. - Add `export PATH="$PATH:$HOME/.config/composer/vendor/bin"` to your `.bashrc` file. - Run the `valet install` command. This will configure and install Valet WSL with all the required services, it will also register the Valet's daemon to launch when your system starts. - Once Valet WSL is installed, you can run `valet start` to start all the services, and you can check if valet is working by visiting the page `http://localhost`. #### Switching PHP Version [](#switching-php-version) Switch PHP version using the command: ``` valet use ``` Example: ``` valet use 8.1 ``` Use `--update-cli` flag to update PHP cli version as well. ### Database [](#database) Valet WSL automatically installs MySQL. It includes a tweaked my.cnf which is aimed at improving speed. #### Change password [](#change-password) It can be single line of code to change your MySQL password. We don't have to always login to MySQL and find for the query and execute it. It's just that simple as below: ``` valet db:password ``` #### List databases [](#list-databases) ``` valet db:list ``` #### Creating database [](#creating-database) Create a new database using: ``` valet db:create ``` When no name is given it will use the current working directory as the name of the database ``` valet db:create ``` #### Dropping database [](#dropping-database) ``` valet db:drop ``` When no name is given it will use the current working directory as the name of the database ``` valet db:drop ``` ### Domain Alias / Symlinks [](#domain-alias--symlinks) Display all of the registered symbolic links: ``` valet links ``` Add the current folder as a symlink: ``` valet link ``` For example: ``` $(/src/beel) valet link ``` This will create a symbolic link for the current folder and point it to `beel.test` ### Securing sites with TLS [](#securing-sites-with-tls) By default, Valet serves sites over plain HTTP. However, if you would like to serve a site over encrypted TLS using HTTP/2, use the secure command. For example, if your site is being served by Valet on the `example.test` domain, you should run the following command to secure it: ``` valet secure example ``` If you don't provide the name and the current working directory is linked to a domain, it will use the current working directory as the domain. ``` $(/src/beel) valet secure ``` This will make `beel.test` to work with `https://beel.test` License ------- [](#license) Valet WSL is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT) ### Health Score 42 — FairBetter than 90% of packages Maintenance52 Moderate activity, may be stable Popularity19 Limited adoption so far Community10 Small or concentrated contributor base Maturity71 Established project with proven stability Bus Factor1 Top contributor holds 91.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~25 days Recently: every ~98 days Total 21 Last Release 1009d ago Major Versions v1.1.5 → v2.0.02023-08-02 PHP version history (3 changes)v1.0.1PHP ^8.0|^8.1 v1.0.12PHP ^7.4|^8.0|^8.1 v2.0.0PHP ^8.1|^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/007d894ba9912b39d7bd460673f516a0a573fad90c0277a6711167cf323df5c8?d=identicon)[wizzymore](/maintainers/wizzymore) --- Top Contributors [![wizzymore](https://avatars.githubusercontent.com/u/25827787?v=4)](https://github.com/wizzymore "wizzymore (73 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)") --- Tags laravelarchlinuxwindowsubuntuzondawwdhhdvaletfedorawsllaragon ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/eptic-valet-wsl/health.svg) ``` [![Health](https://phpackages.com/badges/eptic-valet-wsl/health.svg)](https://phpackages.com/packages/eptic-valet-wsl) ``` ### Alternatives [cpriego/valet-linux A more enjoyable local development experience for Linux. 1.5k135.9k](/packages/cpriego-valet-linux)[genesisweb/valet-linux-plus Advanced local development experience for Linux. 18215.3k](/packages/genesisweb-valet-linux-plus)[laravel/valet A more enjoyable local development experience for Mac. 2.6k911.9k13](/packages/laravel-valet)[cretueusebiu/valet-windows A more enjoyable local development experience for Windows. 920115.0k](/packages/cretueusebiu-valet-windows)[laravel-zero/framework The Laravel Zero Framework. 3371.4M369](/packages/laravel-zero-framework)[ycodetech/valet-windows A more enjoyable local development experience for Windows. A Windows port of the popular Laravel Valet and a fork of cretueusebiu/valet-windows, with new features. 451.6k](/packages/ycodetech-valet-windows) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)